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ABSTRACT 


The  develooment  and  imolementation  of  refresh  graphics 
software  for  the  Vector  General  Display  System  on  a  PDP-11 
minicomputer  is  discussed.  Modification  and  expansion  of 
existing  software  routines?  along  with  additional  software 
design  and  develooment  is  presented.  As  an  addition  to  the 
existing  C  programming  1  a  n  a  u'a  g  e  /  a  version  of  BASIC  was 
implemented  as  a  second  1 anauage  capable  of  utilizing  the 
Vector  General  software.  The  unsuccessful  imolementation  of 
a  version  of  FORTRAN  with  the  diSDlay  system  software  and 
the  problems  involved  are  discussed.  Conclusions  and 
recommendations  are  offered*  and  a  detailed  user's  manual  is 
appended . 
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I.   INTRODUCTION 


The  Vector  General  Graphics  Disolay  Unit  in  conjunction 
with  the  PDP-11/50  minicomputer  orovides  the  Naval 
Postgraduate  School  Ccmouter  Laboratory  with  a  sophisticated 
t h ree-o i mens i ona 1  graphics  display  system.  Hardware 
facilities  orovide  for  three-dimensional  rotation, 
translation,  and  scaling  of  araohics  data.  Depth-cueing  is 
accomolished  by  varying  object  intensity.  A  circle/arc 
generator,  in  addition  to  a  vector  and  character  generator, 
further  enhances  the  system  by  allowing  the  user  to  draw 
arcs  and  circles  with  soecification  of  only  two  or  three 
points.  Additionally,  external  devices  in  the  form  of  an 
a  1  oh anumer i c  keyboard,  liahted  function  switches,  control 
dials,  trackball i  joystick,  and  lightoen  provide  interactive 
control  of  the  disolay  presentation. 

Integral  to  the  operation  of  the  Vector  General  is  the 
disolay  controller.  The  display  controller  is  a  processor 
*hich  receives  data  from  a  disolay  list,  aecodes  the  data 
into  graphic  commands,  and  activates  the  appropriate 
generator  to  outout  the  desired  information.  The 
construction  and  maintenance  of  the  display  list  is 
accomplished  through  the  use  of  the  Vector  General  Graphics 
Library.  The  liorarv  functions  as  the  interface  between  the 
user  and  display  controller.  SimDle  orimitives  are  provided 
allowing   the  user  to  build  the  disolay  list.   Additionally, 


the  software  allows  the  oisday  controller  to  communicate  to 
the  user  information  obtained  from  external  devices  which 
may  be  used  to  Drogramatically  control  the  display 
oresent  at  i  on  . 

Previous  thesis  work  by  Thorpe  [11]  l\2) ,  Visco  [151/ 
and  Stankowski  [10]  provided  fundamental  graphics  software 
ana  should  be  consulted  for  original  design  considerations. 
The  objective  of  work  described  in  this  thesis  was  to 
review*  modify/  and  extend  orevious  work  to  provide  more 
useable  graphics  software  for  the'Vector  General  Display 
System.  To  this  extent  certain  goals  were  set.  All 
previous  work  was  to  be  reviewed/  revised  and  updated.  A 
significant  portion  of  time  was  to  be  spent  in  testing  and 
debugging  previously  untested  routines.  The  design  and 
i mo  1 emen t a t i on  of  software  to  supoort  the  trackball/ 
joystick/  and  lightpen  facilities  was  to  be  undertaken. 
Extension  of  existing  routines  to  simplify  their  apolication 
had  to  be  accomplished.  Expansion  of  application  languages 
which  support  vector  graphics  to  include  BASIC  and  FORTRAN 
was  seen  as  a  most  significant  goal  of  the  research.  The 
culmination  of  Che  study  was  seen  to  be  the  compilation/ 
testing/  and  evaluation  of  all  existing  and  newly  generated 
software/  and  the  incorooration  of  all  relevant  information 
into  one  user-oriented  reference  manual. 


II.   BACKGROUND 


As  most  of  the  work  discussed  in  this  thesis  concerns 
modifications  and  extensions  to  orevious  thesis  work,  a 
descriDtion  o*  orior  work  is.  in  order.  Thorpe  and  Raetz 
[111  U2]  designed  the  original  data  structures  for 
constructing  and  maintaining  the  display  list.  The  display 
list  was  constructec  by  a  series  of  subroutine  calls  which 
oroduced  the  correct  seauence  of  graphic  commands  resulting 
in  a  picture  generation. 

The  disolay  was  constructed  on  three  hierarchical 
levels:  oicture,  object  »  and  element.  An  element  is  the 
smallest  picture  seament  that  can  be  referenced.  It 
consists  of  a  seauence  of  move,  line,  arc,  circle,  and 
character  commands.  *n  element  must  be  associated  with  an 
object  before  it  can  be  disolayed  and  an  oDject  may  comprise 
a  maximum  of  10  elements.  A  picture  refers  to  all  the  data 
displayed  on  the  screen  and  may  consist  of  uc  to  10  objects. 

Visco  [15]  was  concerned  w i t h  the  design  of  a  multi- 
processor system  to  support  real-time  interactive  graphics. 
Due  to  the  high  orioritv  of  direct  memory  access  (DMA) 
requests  necessary  to  suooort  refresh  graphics,  the  multi- 
processor configuration  was  envisioned  as  a  solution  to  the 
D^A  bus  t i e-uo  problem.  Previous  work  done  by  Thorpe  and 
Raetz  was  modified  by  Visco  to   conform   to   the   envisioned 


syst  em . 

Stankowski  (10)  expanded  uDon  previous  work  bv  allowinq 
the  user  to  construct  elements  and  objects  with  alphanumeric 
names  replacing  the  previous  numbering  convention.  The 
object  "TREE"  could  now  contain  elements  "branchl"  through 
"branchlQ".  Additional lv>  Stankowski  designed  a  number  of 
routines  for  the  user  to  more  easily  construct  a  display 
list. 

O'Oell  C5]  accomplished  the  i mo  1 ement at i on  of  a 
segmen t ed-Drocess  memory  management  UNIX  operating  system 
that  had  been  previously  designed  by  Emery  [31. 
Additional lv/  design  and  implementation  was  done  in  a  dual- 
ported  memory  environment  where  designated  Dort ions  of  core 
were  sharable  regions.  0* Dell's  work  helped  lay  the 
groundwork  for  a  mpre  generalized  system  in  which  additional 
languages  could  suooort  graphics  orograms. 

Previous  oaragraphs  have  oresented  work  completed  prior 
to  the  commencement  of  research  reported  in  this  thesis. 
The  adeauacv  of  the  interface  between  the  user  and  Vector 
General  was  still  in  doubt.  Software  for  the  trackball* 
joystick,  and  lightoen  facilities  was  missing  and  routines 
for  other  external  devices  were  not  readily  useable. 
Although  routines  were  present  to  construct  and  maintain  the 
display  list/  the  majority  of  them  had  not  been  tested. 
Compat ab i 1 i t y  with  O'Oell's  SSUNIX  and  expansion  of 
available  1 anguaaes  beyond  the  C  language  had  yet  to  be 
accomplished.  a i t h  this  in  mind/  a  description  of  the 
modifications  and  enhancements  to  the  system  is  presented  in 
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the  following  sections. 
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III.   LANGUAGE  EXPANSION 


A.  GENERAL 

In  reviewina  the  Vector  General  Display  System  and  the 
Naval  Postgraduate  School  Graphics  Laboratory,  it  was  noted 
that  Tost  of  the  software  was  written  in  C  programming 
language.  This  circumstance  demanded  that  any  further 
language  introduction  would  reauire  compat ab i 1 i t y  with  C  and 
the  UNIX  PDP-11  operating  system.  Two  languages  became  the 
focus  of  attention  due  mainly  to  their  wide  use  and  apparent 
ability  to  call  C  subroutines.  Versions  of  BASIC  and 
FORTRAN  were  chosen  as  the  languages  to  attempt 
implementation  with  the  Vector  General  software.  As  work 
progressed  on  these  languages*  strengths  and  weaknesses  were 
noted  for  both  that  could  effect  further  development  and  use 
throughout  the  Graphics  Laboratory.  The  following  two 
sections  will  explore  each  language/  their  origins  and 
difficulties  in  develooment,  and  implementation. 

B.  BASIC 

1 .   Bac  kground 

In  previous  work,  Robertson  [9]  implemented  an  Extended 
BASIC  compiler.  BASIC  (Beginner's  Al l-ouroose  Symbolic 
Instruction  Code)  was  originally  developed  at  Dartmouth 
College   and   has  undergone  many  changes  to  suit  user  needs. 


12 


The  extensions  implemented  by  Robertson  include  such  items 
as  string  manipulation/  sequential  access  to  external  files, 
mu 1 t i -di mens i ona 1  arrays^  logical  ooerators  for  numeric  and 
string  auantities/  and  the  ability  to  call  C  subroutines. 

The  Extended  BASIC  compiler/  hereafter  referred  to  as 
simply  BASIC/  is  not  a  ourely  interpretive  compiler.  It 
generates  an  intermediate  code  (PDP-11  assembly  language) 
from  the  BASIC  source  oroaram.  BASIC  object  modules  and  C 
subroutine  ooject  modules  are  able  to  be  linked  together. 
One  final  link  and  load  operation  provides  the  ultimate 
interface  between  the  two  different  language  modules. 

The  first  step  in  understanding  BASIC  was  to  follow  the 
operation  of  the  shell  command  which  controls  the 
compilation/  assembly/  and  linking.  This  shell  command/ 
LBAX/  is  a  user-accessible  executable  command  on  the  Naval 
Postgraduate  School's  UNIX  PDP-11  file  system.  The  command 
goes  through  three  phases  of  operation/  all  of  which  depend 
on  the  option  codes  included  (switches  set)  when  the  command 
is  issued.  The  first  phase  is  the  compile  phase.  This 
phase  compiles  the  BASIC  program  source  code  and  emits  a 
PDP-11  assembly  language  file  as  the  output.  The  second 
phase  causes  the  assembly  of  this  assembly  language  file 
using  the  UNIX  assembler  command  "as".  This  assembly  emits 
an  "a. out"  file  for  use  in  a  final  linkina  and  loading 
phase.  The  final  phase  uses  the  UNIX  system  loader  command/ 
"Id"/  to  link  and  load  all  necessary  object  modules.  The 
LBAX  shell  command  automatically  loads  the  resoective  BASIC 
and  C  libraries  to  reconcile  all  undefined  references.    The 
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output  of  this  final  link  and  load  ohase  is  an  executable 
"a. out"  file.  Within  this  final  stage  of  the  LBAX  command, 
an  option  is  invoked  to  regulate  the  UNIX  loader.  This  "-X" 
switch  option  causes  all  C  internally  generated  labels  to  be 
disregarded  while  retaining  only  those  symbols  local  to  the 
routines  themselves.  The  same  switch  is  also  used  in  the 
loading  phase  of  the  C  compile  shell  command  "cc". 

Provisions  in  the  comqilation  phase  of  a  BASIC  program 
ensure  the  emission  of  the  proper  assembly  language  code 
that  allows  interaction  between  the  BASIC  program  and  the  C 
subroutines.  Prior  to  the  actual  call  to  a  subroutine,  the 
"extern"  statement  causes  the  declaration  of  C  subroutine 
ana  the  designation  of  the  type  and  number  of  parameters  to 
be  Dassed.  The  call  to  the  subroutine  is  done  by  the  "call" 
statement.  The  name  of  the  subroutine  and  the  actual 
parameters  Dassed  are  included  within  this  statement. 
Provisions  were  also  made  to  allow  the  user  to  assign  return 
values  from  the  subroutines  to  predefined  variables. 

Initial  investigation  into  Robertson's  BASIC  compiler 
proved  that  the  compiler  has  the  caoability  to  allow  BASIC 
programs  to  call  C  1 anauaae  subroutines.  Robertson's 
Extended  Basic  Users  Manual  should  be  consulted  for  further 
details  concernina  usage. 

2.       Testing  and  Implementation 

Robertson  indicated  that  Extended  BASIC  could  interact 
with  subsystems  oresently  used  at  the  Naval  Postgraduate 
School  Graphics  Laboratory.   Implementation  of  this  language 
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with  the  Vector  General  software  was  never  accomplished  by 
Robertson,  but  the  basic  feasibility  of  implementation  did 
exist.  The  first  tests  attemoted  in  this  development  were 
conducted  to  determine  the  correctness  of  calling  C 
subroutines  from  the  BASIC  program.  Problems  arose  in  the 
passing  of  floating  ooint  oarameters.  In  order  for  such 
parameters  to  be  passed  and  aligned  correctly  within  core 
for  the  C  subroutines,  the  values  expected  by  the  C 
subroutines  had  to  be  declared  as  double  orecision  variables 
within  the  calling  program.  C  language  conventions  exDect 
both  floating  point  and  double  precision  variables  to  De 
stored  in  64  bit  fields.  By  declaring  the  floating  point 
parameters  as  double  crecision  within  the  "extern"  statement 
of  BASIC,  the  oroblem  was  overcome.  Upon  the  completion  of 
successful  parameter  passing  between  BASIC  and  C 
subroutines,  continued  test ina  was  undertaken  to  use  BASIC 
with  the  Vector  General  Library  in  drawinq  oictures  on  the 
Vector  General  display. 

Since  development  of  the  Extended  Basic  compiler  and  its 
accompanying  software,  the  Graphics  Library  was  physically 
relocated  within  the  UNIX  file  system.  Many  of  the  special 
device  libraries  were  also  renamed.  The  LBAX  shell  command 
had  to  be  updated  to  reflect  these  chanqes.  An  updated  copy 
of  the  source  and  executable  versions  of  the  special  device 
libraries  were  placed  on  the  system  for  general  use. 

In  preparing  a  BASIC  program  for  execution  envoi vinq  the 
Vector  General  disolav,  differences  were  noted  in  the  format 
of  BASIC  and  C  programs.   The  C  program   contained,   as   its 
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first  program  statement,  an  "include"  statement.  Thorpe 
[111  and  Stankowski  [101  reauired  this  statement  to  load  the 
initilized  disolay  list  in  the  >  proper  sequence.  The 
oosition  of  this  statement  in  the  orogram  ensured  that  upon 
compilation,  the  display  list  would  be  located  at  the 
beginning  of  the  process's  data  segment  in  core  space.  The 
start  of  the  display  list  could  be  located  for  refreshing  by 
knowing  the  oosition  of  the  orocess's  data  segment. 

The  compilation  technique  mentioned  in  the  preceding 
oaragraph  is  an  important  design  item  in  Visco's  Vector 
General  device  drivers  [151.  when  designing  the  device 
drivers,  Visco  had  to  ensure  that  the  start  of  the  display 
list  could  be  easily  located.  He  also  wanted  to  ensure  that 
* i t h  a  snarable  core  region,  the  only  segment  of  the  process 
located  within  this  region  was  the  data  segment.  By 
compiling  a  C  Vector  General  program  with  a  "-i"  switch  set, 
the  file  aenerated  for  execution  is  designated  a  411 
filetyoe.  This  executable  file  is  distinguished  in  that  the 
text  and  data  segments  reside  in  separate  address  space  [81. 
Upon  execution,  the  start  of  the  aata  soace  is  alianed  at 
the  oeginning  of  a  32  K  word  boundary  in  core.  The  refresh 
cycle  is  accomplished  by  repeated  execution  of  the  display 
list  which  begins  at  this  32  K  word  boundary. 

Two  major  problems  had  to  be  overcome  in  order  to  use 
the  Vector  General  disolay  with  a  BASIC  program  that  called 
C  subroutines.  Unlike  C,  BASIC  made  no  provisions  for  an 
"include"  statement.  BASIC  would  have  to  cause  the  loadinq 
of  the  initialized  display  list   by   some   other   means.    A 
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concatenation  of  an  i n i t i 1 i zat i on  list  could  not  be  appended 
to  the  beginning  of  the  BASIC  oroaram  because  of  the  failure 
of  the  language  to  recognize  certain  key  characters  within 
the  list.  Such  characters  as  the  "<-"  or  underscore 
character,  often  used  within  C  variables*  are  unrecognizable 
and  return  error  conditions.  A  decision  was  made  to  call  a 
dummy  C  subroutine  which  would  cause  the  loading  of  the 
initialized  display  list  in  the  proper  sequence.  Such  a 
change  demanded  a  modification  of  the  technique  by  which  the 
Vector  General  device  driver  locates  the  display  list  data. 
Visco's  temporary  drivers  had  to  be  modified  to  find  and 
communicate  the  offset  of  the  display  list  from  the 
oeginning  of  the  data  segment. 

The  second  major  problem  that  was  encountered  in 
development  of  BASIC  was  the  inability  of  BASIC  programs 
with  C  subroutine  calls  to  be  designated  as  411  filetypes 
upon  compilation.  The  standard  file  emitted  after  a  BASIC 
compile  was  a  407  filetype,  text  and  data  being  mixed  within 
the  file.  "^o  provisions  were  made  in  the  L6AX  shell  command 
for  inclusion  of  the  "  -  i  "  switch  to  split  instruction  and 
data  space  (14  0  space  ).  When  the  loading  phase  of  the 
shell  command  was  changed  to  include  this  option,  execution 
of  the  final  executable  object  module  proved  unsuccessful. 
As  no  provisions  were  made  in  the  compiler  to  cause  data  and 
text  instructions  to  be  placed  on  separate  stacks,  the 
passing  of  various  oarameters  to  C  subroutines  was  unable  to 
oe  accomplished  correctly.  It  was  realized  that  changing 
the  BASIC  comoiler  to  emit  the  proper  intermediate   assembly 
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language  code  was  beyond  the  scope  of  the  original  intent  of 
this  research  . 

A  different  aoDroach  was  taken  in  an  attempt  to  overcome 
the  problem.  This  approach  involved  imolementing  a  newly 
constructed  UNIX  operating  system  which  used  a  segmented- 
orocess  memory  manager  in  conjunction  with  previsions  for 
shared  core  regions.  The  shared  core  regions  were  recently 
installed  in  the  hardware.  O'Dell  [51  implemented  such  a 
system  called  SUNIX  for  the  Naval  Postgraduate  School 
Comouter  Laboratory.  One  version,  SSUNIX,  was  imDlemented 
for  the  PDP-11/50  Drocessor  for  use  with  the  graphics 
display  eguioment.  Although  not  operational,  this  hybrid 
UNIX  operating  system  was  planned  to  be  implemented  in  the 
comouter  laboratory.  In  discussions  with  O'Dell,  SSUNIX  was 
descrioed  as  a  solution  to  BASIC'S  oroblem  of  intermixing 
text  and  data  instructions.  SSUNIX  could  distinguish  and 
prooerly  execute  either  the  411  or  407  filetyoe  processes 
within  the  shared  memory  region.  The  generalization  of  the 
Vector  General  device  drivers  and  the  proper  interface 
between  the  drivers  and  the  SSUNIX  system  would  be  the  final 
items  to  reconcile  in  completinq  the  i  mo  1  emen  t  a  t  i  on  . 

Through  much  testing  and  debugging,  BASIC  was 
implemented  as  a  second  high-level  programming  1 anquage  for 
use  with  the  Vector  General  Graphics  Display  System. 
Portions  of  SSUNIX  had  to  be  modified  to  effect  this  goal. 
All  documentation  for  chanaes  to  SSUNIX  and  the  Vector 
General  device  drivers  are  discussed  in  followinq  sections. 
The  use  of  BASIC  as  a  Vector  General  programming  language  is 
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presented   in   Apoendix   A   0f   the   Vector   General   User's 
Reference  Manual. 

C.   FORTRAN  IV-PLUS 

1 .   Bac  kground 

Much  of  the  work  in  attemDtinq  the  implementation  of  F4P 
(FORTRAN  IV-Plus)  with  the  Vector  General  software  was 
similar  to  work  accomclished  in  the  BASIC  implementation. 
F  4  P  did  require  several  different  techniques  for 
development.  More  develooment  work  is  needed  before  F  4  P  can 
Decode  comoletely  inteqrated  with  the  Vector  General 
software. 

F4P  was  developed  for  the  Diqital  Eauipment  Corporation 
[2]  by  the  Commercial  Union  Leasing  Corooration  (CULC)  to  be 
imolemented  under  the  UNIX  ooeratinq  system.  The  Naval 
Postgraduate  School  received  executable  versions  of  the 
compiler  but  had  no  access  to  the  source  code  for  it  or 
associated  software.  This  associated  software  included 
files  for  convert inq  reaular  object  modules  into  F UP  object 
modules*  files  for  clacinq  F4P  object  modules  into  library 
format*  and  files  'or  linking  F  4  P  ooject  modules  together 
into  an  executable  object  module.  Source  code  and 
documentation  were  not  available  during  the  development  time 
frame;  this  lack  of  documentation  and  source  for  F4P  and 
associated  routines  made  it  very  difficult  to  completely 
develop  F4P's  use  of  the  Vector  General  software. 

The  task  of   imolementing   F4P   to   call   C   subroutines 
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proved  to  be  quite  different  than  that  of  the  BASIC  and  C 
integration.  Such  an  i mo  1 emen t at i on  will  reauire  more 
research  and  testing  before  it  is  fully  accomol  i shed .  Two 
important  items  of  imformation  were  known  about  F4P  and  its 
associated  software.  Fup  uses  "DEC  standard"  object 
modules;  these  are  guite  different  than  the  C  object 
modules.  Al so/  orior  to  use/  C  object  modules  would  have  to 
be  converted  to  F  4  P  readable  object  modules. 

Two  software  items  were  available  which  were  advertised 
to  allow  F^P  oroarams  to  call  C  Drogramming  language 
suoroutines.  The  "conv"  command  could  be  used  to  convert  a 
C  object  module  into  an  F4P  readable  object  module.  With 
all  current  Vector  General  software  written  in  C/  separate 
libraries  made  up  of  the  converted  C  object  modules  would 
have  to  be  constructed.  The  "callc"  routine  was  the  second 
item  designed  to  comolete  the  interface  between  the  F4P 
program  and  the  C  subroutine.  This  routine  stacks  up 
parameters  for  C  subroutines/  executes  the  external  C 
subroutine/  and  returns  to  the  calling  F4P  program. 

Differences  that  did  not  exist  in  the  BASIC 
implementation  were  encountered  in  the  calling  of  C 
suoroutines  by  F  4  P  programs.  All  C  subroutines  had  to  be 
separately  compiled  by  the  C  compiler  into  object  modules 
prior  to  conversion.  The  F4P  "linker"  prohibits 
concatenated  suoroutines  from  being  compiled  together  and 
properly  linked  with  the  calling  F  4  P  object  modules.  Also/ 
as  previously  mentioned/  the  C  subroutine  object  modules  had 
to  be  converted  to  F4P  readable  object  modules  by  the  "conv" 
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command . 

The  software  that  would  allow  the  communication  between 
F  4  P  and  C  subroutines  is  the  " c a  1  1 c "  routine.  The  source 
for  this  routine  is  an  Mil  assembly  language  routine  which 
had  to  be  assembled  by  the  Macro  assembler.  This  Macro 
assembler  is  one  of  the  executable  files  which  was  included 
in  the  associated  software  suoporting  the  FUP  compiler.  The 
resulting  "callc.obi"  and  a  seldom  used  "ca 1 1 c v  .ob j "  modules 
orovide  the  user  with  the  facility  to  place  the  parameters 
to  be  passed  to  the  C  subroutine  in  a  stack  and  to  jump  to 
the  C  subroutine  which  is  called.  The  comoletion  of  the 
subroutine  allows  control  to  return  to  the  FUP  calling 
program.  The  "callc.obi"  module  would  have  to  be  included 
in  the  link  phase  of  all  the  modules  in  order  to  obtain  an 
executable  FUP  file.  An  imoortant  feature  of  the  "callc" 
routine  is  that  it  works  with  oointers  to  the  Darameters 
rather  than  the  Darameters  themselves.  This  C  oarameter 
representation  necessitated  changing  the  C  subroutines  to 
expect  oointers  to  the  oarameters  instead  of  the  values  of 
the  oa  r ame t  er s  . 

In  dealing  with  the  reauirement  for  seoarate  compilation 
of  subroutines  and  the  call  by  name  Darameter  passing,  a 
seoarate  Vector  General  library  was  needed  to  accomolish  trie 
task.  The  "libr"  command  would  have  to  be  utilized  to  olace 
the  modules  in  a  single  library  similar  to  the  archive 
command  "ar"  within  the  C  language.  Each  Vector  General 
Library  subroutine  had  to  be  updated  to  reflect  the  oassinq 
of   L-values   and   then  recomoiled.   After  conversion  of  the 
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object  modules  into  FaP  readable  object  modules/  the  modules 
would  have  to  be  olaced  in  a  new  F4P  Vector  General  Library. 
The  following  section  will  discuss  the  testing  and  attempted 
implementation  of  F4P  as  a  third  language  capable  of  using 
the  Vector  General  software. 

2.        Testing  and  Implementation 

After  general  tests  were  conducted  and  proved  the 
ability  of  F4P  to  correctly  call  C  subroutines,  testing  was 
conducted  on  a  simple  FUP  program  that  would  use  the  newly 
constructed  Vector  General  Library  of  F4P  object  modules. 
Two  non-fatal  errors  continued  to  arise  in  the  testing  runs. 
The  two  C  library  subroutines*  "ecvt"  and  "  f  c  v  t  "  *  were 
aescribed  as  multiply  defined  in  the  error  listing.  Upon 
review  of  the  source  code  listings  for  the  two  items*  it 
became  evident  that  four  different  assembly  language 
suoroutines  -ere  involved:  "«-ecvtH*  M«-fcvt"*  "ecvt"*  "fcvt". 
FaP  does  not  recognize  the  "«-"  or  underscore  character,  but 
unlike  BASIC*  it  disregards  the  symbol  entirely.  Through 
continued  testing*  the  non-distinction  between  the  two 
similar  pairs  of  subroutine  names  was  found  to  be  no 
detriment  to  orogram  loading  and  execution.  Correction  of 
this  problem  would  recuire  rewriting  the  C  subroutine  calls. 

A  second  error  of  some  significance  was  found  while 
test ina  proceeded.  According  to  C  programming  language 
documentation  [7]*  C  allows  a  user  to  assign  a  floating 
point  value  to  an  integer  variable.  Such  an  assignment 
performs  truncation  towards  zero  on  the  floating  point  value 
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and  assigns  the  whole  number  value  to  the  integer  variable. 
An  inconsistency  was  found  in  the  methods  that  C  and  F4P  use 
in  the  truncation  of  floating  point  numbers. 

The  converting  command  "conv"  was  found  to  change  this 
basic  coding  seauence  to  a  seauence  which  placed  the 
truncated  floating  point  value  into  a  long  integer  with  a 
length  of  32  bits.  Such  a  change  would/  in  effect,  cause 
only  the  uDoer  16  bits  of  information  to  be  used.  To  remedy 
the  situation,  without  being  able  to  physically  update  the 
source  code  of  the  convert  routine/  all  instances  of  such  an 
operation  would  have  to  be  located  and  corrected  within  the 
C  subroutine.  Each  instance  was  changed  to  reflect  that  the 
integer  variable  was  a  temoorary  long  integer  variable. 
This  was  immediately  followed  by  the  long  integer  variable 
Deing  assigned  to  a  16  bit  integer.  The  change  was  proven 
effective  and  was  instituted  in  the  F  4  P  Vector  General 
Library  for  the  " vgabsca  1  e" /  " vgre  1  sea  1  e  "  /  and  "vgpscal" 
rout  i  nes  . 

After  continued  testing/  one  final/  fatal  problem  was 
discovered  with  the  interaction  between  the  F  4  P  and  the 
Vector  General  software.  When  Vector  General  subroutines 
are  converted  into  F4P  readable  object  modules/  certain 
switches  are  set  by  default.  These  switches  govern  the 
overlay  use  in  the  "linker"  phase  ana  the  global  recognition 
of  different  seaments  which  are  changed  to  "psects".  It 
oecoTies  oossible  for  more  than  one  cooy  of  global  variables 
to  exist.  In  checking  the  display  list  located  in  core/  two 
seoarate   disolay  lists  were  found  to  exist/  each  containing 
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information  not  held  by  the  other.  Information  necessary 
for  refreshing  the  disolay  list  was  inaccessable  to  the 
device  drivers.  In  short*  one  complete  uodated  disolay  list 
did  not  exist. 

The  inability  to  implement  F4P  as  the  third  language 
capable  of  utilizina  the  Vector  General  Graphics  Display 
Svstem  was  not  the  result  of  any  one  item.  The  lack  of 
source  code  for  the  software*  ooor  documentation  on  F4P 
accompanying  software*  and  inherent  differences  in  the 
structure  of  C  and  FUP  were  all  contributing  factors.  The 
implementation  of  F  U  P  in  the  Vector  General  environment 
should  oe  possible  by  obtaining  orooer  documentation.  The 
final  hurdle  to  overcome  would  be  the  problem  of  multiple 
copies  of  the  disolay  list.  Recommendations  for  future  work 
in  tnis  area  will  be  made  in  the  final  chapter  of  this 
thesis. 
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IV.   GRAPHICS  SOFTWARE 


Modifications  and  enhancements  to  graohics  software  fall 
within  three  categories:  external  device  interfacing, 
display  list  suooort ing  software*  and  general  system 
i  morovement  s . 

A.   EXTERNAL  DEVICE  INTERFACING 

The  external  devices  may  be  used  to  p rogramat i ca 1 1 y 
control  the  disolay  Dresent a t i on  .  A  1 ohanumer i c *  analog* 
logical/  positioning*  and  lightDen  data  may  be  returned  to 
t^e  user's  orogram  through  the  graohics  routines. 

1 .   Keyboard 

Alphanumeric  data  entry  is  accomplished  through  the 
Vector  General  keyboard.  Depression  of  any  key  enters  an  8 
bit  ASCII  character  code  into  the  keyboard  register  and  sets 
the  priority  interrupt  request  indicating  a  character  has 
oeen  entered.  Upon  executing  the  interrupt  handler*  the 
character  code  is  placed  in  a  keyboard  buffer  to  await  a 
call  from  the  user's  proaram.  The  "cget"  routine  was 
designed  to  return  the  data  entered  from  the  keyboard.  The 
"cget"  routine  buffers  the  data  until  a  carriage  return  is 
received*  whereupon  the  entire  alphanumeric  string  is  made 
available  to  the  user's  program.  The  buffering  of  input 
data  was  desianed  to  allow  erasing  of  erroneous  data.   As  no 
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data  is  available  to  the  user's  program  prior  to  a  carriage 
return,  incorrectly  entered  data  may  De  removed  by  repeated 
control-a  keystrokes. 

The  "cget"  routine  solved  the  reguirement  for  returning 
alphanumeric  data  strinas  to  the  user's  program. 
Determination  of  integer  and  floating  point  numbers, 
however,  presented  an  additional  problem.  Recognition  of 
integer  or  floating  point  numbers  from  a  character  string 
requires  the  conversion  of  ASCII  data  to  numerical  data. 
The  svstem-resident  C  library  contained  two  routines,  '"geti" 
and  "getf",  which  accomolish  the  desired  ASCII  to  integer  or 
float  conversions.  Use  of  the  system  routines  was  judged 
more  desirable  than  inventing  new  software. 

Two  new  routines,  "faet"  and  Miget",  were  written  which 
set  condition  flags  and  pass  control  to  the  system  "getf" 
and  "geti"  routines  to  accomplish  the  conversions.  A  new 
"getchar"  routine  was  written  to  replace  the  system-resident 
"getchar"  routine.  Ucon  executing  either  the  "getf"  or 
"geti"  routine,  a  call  is  made  to  the  new  "getchar"  routine 
to  obtain  a  character.  Normally,  the  default  input  device 
would  be  interrogated  for  the  desired  character.  However, 
due  to  the  condition  flag  set  in  the  previous  execution  of 
the  "fget"  or  "iget"  routines,  the  "getchar"  routine 
requests  the  character  from  the  Vector  General  keyboard. 
Repeated  calls  to  "getchar"  are  made  by  the  system  "geti" 
and  "getf"  routines  until  a  carr i  age  return  is  received. 
The  routine  determines  the  integer  or  floating  point  number 
it  has  within  its  ASCII  strina  and  returns   that   number   to 
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the  calling  routine.   The  result  is  that  the  user  is  able  to 

obtain   integer   or   floating   point  numbers  from  either  the 

console  or  Vector   General   keyboard   without   an  excessive 
amount  of  additional  software. 

2.   Function  Switches 

The  32  lighted  function  switches  orovide  for  logical 
true/false  information  to  be  available  to  the  user's 
program.  Three  routines  were  added  to  enhance  the  use  of 
the  function  switches.  The  "fsman"  routine  was  desianed  to 
return  the  status  of  the  desired  function  switch.  If 
physically  depressed/  a  logical  value  of  true  or  one  (1)  is 
returned  to  the  user.  . If  not  depressed*  a  logical  value  of 
false  or  zero  (0)  is  returned. 

The  "lamp"  routine  was  desianed  to  light  or  extinguish 
the  lamp  of  the  desired  function  switch.  No  dependence  on 
the  status  of  the  function  switch  is  inherent  in  the 
operation  of  the  "lamp"  routine.  The  routine  can  be  used  to 
light  a  function  switch  to  indicate  t^at  a  certain  condition 
has  been  attained. 

The  "fstog"  routine  was  designed  to  further  extend  the 
ease  in  utilizing  the  function  switches.  The  "fstog" 
routine  creates  the  illusion  the  function  switches  are 
toggles  which  flip-flop  their  logical  value  as  well  as  their 
lamp  status  with  each  depression  of  the  switch. 
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3.  Control  Dials 

Analog  information  is  made  available  to  the  user  through 
the  use  of  the  10  control  dials.  Integer  values  returned 
from  the  control  dials  vary  from  -2048  to  2047,  the  maximum 
obtainable  from  the  12  bit  system  register.  Floating  point 
values  returned  to  the  user  through  the  dial  routiner 
however,  vary  from  -1.0  to  1.0.  This  range  can  be  easily 
extended  within  the  user's  program.  Analog  values  obtained 
through  tne  dial  routine  are  useful  for  adjusting  other 
program  variables  such  as  rotation  rates  and  translation 
soeeds  . 

4 .  Trackbal  1 

Previously  mentioned  devices  have  no  connection  with 
what  the  user  is  primarily  interested  in,  the  display 
screen.  The  trackball  is  an  external  device  designed  to 
provide  visual  oositioning  feedback  to  the  user  of  data  on 
the  display  screen.  This  visual  feedback  is  obtained  by  the 
acoearance  of  a  small,  blinking  cursor  on  the  display 
screen.  Movement  of  the  user's  hand  across  the  round, 
plastic  trackoall  causes  the  software-generated  cursor  to 
move  in  an  aopropriate  manner. 

The  display  of  the  trackball  cursor  is  accomplished  in  a 
manner  similar  to  other  elements.  A  sequence  of  commands  is 
executed  by  the  disolay  controller  which  draws  a  small  cross 
at  the  origin  of  the  X-Y  axis.  Each  refresh  cycle  the 
trackball's  X  and  Y  coordinate  registers  are  updated  and 
used   to   modify   the   coordinate   axis   of  the  cursor.   The 
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cursor  is  moved  reflecting  any  user  movement  of  the 
trackball.  To  insure  cursor  display^  all  cursor  generating 
code  is  inserted  in  the  display  list  prior  to  the  code  for 
any  other  element. 

Two  routines  were  designed  to  be  used  with  the  trackball 
facilities.  The  "cursor"  routine  was  designed  to  activate 
or  deactivate  the  aisplav  of  the  trackball  cursor. 
Activation  is  accomolished  bv  ensuring  that  the  display 
controller  executes  the  cursor  drawing  code.  Deactivation 
is  accomplished  by  the  disolay  controller  skipping  the 
cursor  generating  code  within  the  disolay  list.  The  "posit" 
routine  was  designed  to  return  to  the  user's  program  the 
position  of  the  cursor  on  the  display  screen.  The  "posit" 
routine  returns  a  floatina.  point  value  of  the  cursor's 
position  within  the  defined  coordinate  system  and  is  not 
aeoendent  on  the  active  disolay  of  the  trackball  cursor. 

5 .   Joy st  i  c  k 

The  joystick  is  an  external  device  similar  to  the 
trackball  in  that  it  provides  visual  positioning  feedback  to 
the  user.  Unlike  the  trackball*  the  joystick  appears  to 
move  three-dimensional  1 y.  Movement  along  the  Z  axis  is 
accomolished  by  variance  in  the  intensity  level  of  the 
blin<ing  joystick  cursor.  As  the  user  twists  the  joystick 
knob  to  move  the  cursor  further  Pack  into  the  display 
screen/  the  intensity  level  of  the  cursor  display  is  reduced 
giving  the  appearance  that  it  is  fading  into  the  distance. 

Joystick  cursor  generating   commands  are       inserted   and 
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uodated  in  the  display  list  just  like  the  trackball  cursor 
commands.  Both  the  "cursor"  and  "Dosit"  routines  work 
eaually  well  for  the  joystick  with  the  addition  that  a  Z 
dimension  is  available  for  the  joystick  "Dosit"  routine. 
Both  the  trackball  and  joystick  cursors  are  useful  in 
providing  the  user  with  visual  feedback  to  interactively 
position  display  elements. 

o.   LightDen 

Ahile  the  trackball/  joystick,  and  associated  cursors 
orovide  oositioning  information,  the  lightoen  is  unique  in 
its  ability  for  pointing  or  identifying  a  portion  of  the 
disDlay.  The  lightcen  does  not  write  on  the  screen,  but 
senses  light  from  the  disolay  on  its  ohotocell.  N o  t  all 
elements  drawn  on  the  disolay  screen  cause  lightoen 
interruDts.  An  element's  lightDen  enable  bit  must  be  set 
with  the  "lahtoen"  routine  or  no  lightoen  interrupt  will 
occur.  Once  the  enable  bit  is  set  ana  the  ODerator  is 
oointing  the  liqhtoen  at  a  portion  of  the  element,  the 
display  controller  causes  the  lightoen  interrupt  to  occur. 

The  objective  of  the  Mghtpen  interrupt  handler  is  to 
determine  what  portion  of  the  display  caused  the  interrupt. 
After  aoprooriate  action  is  taken,  the  processor  is  allowed 
to  continue  what  is  was  executing  orior  to  the  interruot. 
To  determine  wnat  element  caused  the  interrupt  each  element 
is  given  an  element  number.  This  element  number  is  loaded 
in  a  register  just  orior  to  the  actual  drawing  of  the 
element.     Uoon   encountering   a   lightoen   interrupt,   the 
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interruot  handler  interrogates  the  element  number  register 
to  determine  the  element  causing  the  interrupt.  Each 
element  has  a  lightoen  flag  associated  with  it  within  the 
data  structures.  Upon  determining  the  element  which  caused 
the  interruot  the  interrupt  handler  sets  the  appropriate 
flag  and  releases  the  processor  to  continue  what  it  was 
doing  orior  to  the  interrupt.  The  interrupt  handler  was 
kept  as  simple  as  possible  to  minimize  the  amount  of  time 
the  Drocessor  must  soend  on  interruots. 

Two  new  routines  were  designed  to  help  suDPort  the 
lightpen  facilities.  The  " penhit"  routine  was  designed  to 
return  to  the  user  a  logical  true/false  reply.  This  reply 
was  in  answer  to  whether  a  particular  element  or  object  had 
generated  a  lightoen  hit.  The  routine  determines  which 
element  or  object  is  in  Question,  checks  the  aooropriate 
element  lightoen  flag,  and  returns  the  results  to  the  user. 
The  routine  was  made  general  enough  that  it  could  check  for 
a  lightpen  hit  on  an  individual  element,  an  object,  or  the 
entire  d  i  c  t  u  re . 

The  "clrhit"  routine  was  desianed  to  clear  individual, 
grouos,  or  all  elements  of  orevious  lightoen  strikes.  The 
routine  resets  lightpen  flags  to  the  clear  position  in 
oreoaration  for  identifying  new  lightoen  strikes. 

Although  the  caoabilities  of  the  lightpen  make  it  an 
ideal  device  for  oointing  or  identifying  portions  of  the 
disolav,  the  inclusion  of  additional  software  made  the 
lightpen  an  eaually  good  Dositioning  device.  8y  including 
additional  draw  commands  in  the  display   list   in   the   same 
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area  as  the  commands  for  the  trackball  and  joystick  cursors/ 
a  lightpen  cursor  was  made  available  to  the  user.  The 
lightpen  cursor  is  an  oc t oqon-shaped  object  which  may  be 
moved  with  the  helo  of  the  lightpen.  The  "tightpen  cursor 
«as  constructed  with  eight  elements  comprising  the  eight 
sides  of  the  cursor.  Uoon  approaching  the  lightpen  cursor 
with  the  lightpen,  the  cursor  appears  to  latch  on  and  follow 
the  liqhtoen  about  the  disolav  screen. 

The  trackina  of  the  lightoen  cursor  is  accomplished  by 
aetermining  which  side  of  the  lightpen  cursor  first 
initiates  a  lightoen  hit.  Moving  of  the  coordinate  axis  of 
the  cursor  is  then  acco^o 1 i shed ,  minimizing  the  distance 
Detween  the  center  of  the  cursor  and  the  lightpen.  The 
determination  of  the  side  initiating  the  lightpen  strike  is 
accomplished  within  the  interrupt  handler.  Distinction 
between  the  sides  of  the  lightpen  cursor  and  other  lightpen 
nookable  elements  is  accomolished  by  providing  the  lightoen 
cursor  with  8  unique  element  numbers. 

As  with  the  trackball  and  joystick,  two  routines  provide 
lightoen  cursor  oositioning  information  to  the  user.  The 
"cursor"  routine  is  essential  in  activating  ana  deactivating 
the  disolav  of  the  lightoen  cursor.  Unlike  the  trackball 
and  joystick  cursors,  the  lightoen  cursor  must  be  displayed 
to  be  updated.  The  "oosit"  routine  returns  the  floating 
ooint  position  of  the  lightoen  cursor  within  the  defined 
coordinate  system. 
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8.   DISPLAY  LIST  SUPPORTING  SOFTWARE 

In  reviewing/  revising/  and  extending  existing  software/ 
many  tests  and  changes  were  required.  The  "arc"  and 
"circle"  routines  were  rewritten  to  provide  for  correct 
manipulation  of  associated  center  and  endpoint  arguments. 
The  "setvector"  and  "endele"  routines  were  revised  to  ensure 
proper  termination  of  display  list  element  blocks  and  to 
correct  deficiencies  in  the  generation  of  auto-increment 
arcs  and  circles.  The  "intscale"  routine  was  revised  and 
extendea  to  allow  the  user  to  specify  whether  intensity 
cutoff  plane  provisions  were  to  be  in  effect.  Changes  to 
other  routines  included  additional  software  to  inhibit  error 
conditions/  and  correlating  routines  to  proviae  optimal  use 
of  available  display  list  space.  Three  routines  received 
particular  attention  and  reauire  a  fuller  explanation. 

1 .   Remove  Rou  t  i  ne 

As  oriainally  designed  the  graohic  system  data 
structures  provide  for  a  display  list  of  a  fixed  length  in 
size.  Should  all  the  display  list  be  utilized/  no 
additional  data  would  be  displayed.  For  example/  should  the 
first  element  of  the  first  object  the  user  builds  use  uo  the 
entire  display  list/  no  additional  elements  could  be 
displayed  even  though  only  one  element  of  one  object  had 
been  used.  Normally  such  a  situation  would  not  occur; 
however/  snould  numerous  large  elements  be  constructed  this 
same  problem,  lack  of  available  display  list  space,  could 
arise.   The  "remove"  routine  was  designed  to  help  solve   the 
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problem.  The  user  specifies  those  elements  no  longer 
essential  to  the  disolay  which  can  be  eliminated*  thereby 
creating  available  space  within  the  display  list  for 
additional  elements. 

A  somewhat  analogous  situation  occurs  within  the  memory 
management  techniaues  of  most  operating  systems.  Various 
methods  have  been  devised  to  recover  available  memory 
segments  and  reduce  f raament at i on .  The  importance  of 
recovering  unused  or  fragmented  memory  space  in  memory 
management  techniaues  cannot  be  overemohasized.  The 
efficiency  of  the  entire  system  may  aeoend  on  the  judicious 
use  of  available  memory.  As  the  importance  of  recovering 
available  disolay  list  s  o  a  c  e  for  a  process  already  running 
in  memory  is  somewhat  lower  than  for  memory  management 
techniques*  a  less  sooh i s t i cat ed  method  was  designed  for  the 
"remove"  routine. 

Upon  receiving  a  list  of  nonessential  elements  from  the 
user*  the  "remove"  routine  sequentially  processes  the 
removal  of  each  block  of  element  commands.  The  freed  block 
is  buroed  or  bubbled  through  the  disolay  list  by  movina 
succeeding  element  blocks  uo  within  the  disolay  list.  The 
movement  of  element  blocks  within  the  disolay  list  requires 
the  adjustment  of  address  oointers  to  these  element  blocks 
to  ensure  oroper  ooeration  of  the  disolay.  As  the  location 
of  active  element  blocks  are  moved  to  free  unused  memory 
locations*  disolay  list  refreshing  is  inhibited  during  this 
ooeration.  This  procedure*  though  costly  in  execution  time 
for   a   series   of  elements*  was  deemed  more  suitable  than  a 


34 


more  sophisticated  method  which  would  have  cost  the  user 
additional  memory  soace.  Additionally*  this  simole 
techniaue  was  preferred  because  the  "remove"  routine  was  not 
expected  to  be  used  so  freauently  within  a  program  that  a 
momentary  delay  in  execution  would  be  noticed. 

2 .   Printv  "out i  ne 

As  originally  implemented*  the  graphics  software 
provided  for  only  one  tyoe  of  element  containing 
alDhanumeric  data.  The  "charele"  routine  was  used  to 
SDecify  the  contents  of  the  character  string  which  could 
contain  any  of  the  characters  available  in  the  Vector 
General  character  set  olus  a  few  format  instruction  codes. 
Provisions  for  chanaing  the  contents  of  an  element's 
character  string  were  nonexistent. 

A  search  was  conducted  to  determine  the  most  feasible 
way  of  providing  for  an  element  which  could  handle  changing 
character  strings  and  also  provide  expanded  formatting 
caoab i 1  i t i es  .  The  success  of  the  "fget"  and  "iget"  routines 
in  using  system  routines  focussed  attention  on  the  system 
"printf"  routine.  The  "printf"  routine  converts*  formats* 
and  orints  its  parameters  after  the  first  argument*  under 
control  of  the  first  argument.  The  first  argument*  the 
format  argument*  consists  of  characters  and  conversion 
SDec i  f i cat i ons .  It  was  felt  that  a  combination  of  the 
"cnarele"  and  "printf"  routines  could  exDand  the  use  of 
Character   strings   used   within   the  Vector  General  Display 


35 


Sy st  em . 

In  accomplishing  the  merger  of  the  "printf"  and 
"charele"  routines  two  new  routines  were  written.  The 
"  o  r  i  n  t  v  "  routine  contains  arguments  from  both  the  "charele" 
and  "printf"  routines.  Positioning  and  character  string 
initialization  arguments  are  similar  to  those  in  "charele" 
while  format  and  conversion  arguments  are  similar  to  the 
"printf"  routine.  The  "  p  r  i  n  t  v  "  routine  Dasses  its  format 
and  conversion  arguments  to  the  svstem  "printf"  routine  to 
accomolish  the  actual  convertina  and  formatting  of  the  ASCII 
character  string.  As  the  "printf"  routine  must  call  the 
system  "outchar"  routine  to  output  characters*  a  newly 
designed  "outchar"  routine  was  substituted  for  the  system- 
resident  routine  to  outout  characters  to  both  the  console 
and  Vector  General  disolay  screen. 

The  "printv"  routine  aives  the  user  a  great  1 v  expanded 
caoability  in  handling  character  strinqs.  Although  the 
"Drintv"  element  reauires  additional  display  list  space  over 
that  of  a  "charele"  element/  the  exoanded  formatting  and 
conversion  caoabilities  of  the  "Drintv"  element/  in  addition 
to  its  ability  to  be  used  reoeatedly  for  different  character 
strings*  makes  it  a  highly  useful  enhancement  to  the  display 
list  suooorting  software. 

3  .   Disolay  Rou t  i  ne 

As  mentioned  oreviously»  an  element-object  link  must  be 
estaolished  to  disolay  elements  on  the  screen.  While  both 
the  "remove"  and  "erase"  routines  caused   the   disappearance 
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of  an  element  from  the  display  screen/  no  routine  was 
available  ^o  activate  or  deactivate  the  display  of  an 
element  without  affecting  the  e 1 ement -ob j ec t  association. 
The  "display"  routine  was  desianed  to  accomplish  such  a 
purpose.  By  replacing  certain  graphic  commands  within  the 
disDlay  list  with  subroutine  return  commands/  the  display 
controller  mav  be  made  to  skio  execution  of  an  element's 
draw  commands.  This  effectively  deactivates  the  display  of 
the  element  without  affecting  the  element-object 
associations.  Activation  of  the  element  is  then 
accomplished  by  reinserting  the  original  commands  in  the 
disolay  list  such  that  the  display  controller  executes  the 
element's  draw  commancs  on  the  next  refresh  cycle.  The 
"display"  routine  allows  the  user  to  turn  an  element's 
display  on  or  off  without  affecting  the  necessary  element- 
object  associations.  Thus  the  number  of  routines  required 
to  activate  or  deactivate  an  element's  disolay  is  less  than 
if  either  the  "remove"  or  "erase"  routine  had  been  called. 

C.   GENERAL  SYSTEM  IMPROVEMENTS 

«any  of  the  revisions  and  extensions  to  system  software 
previously  mentioned  could  equally  qualify  as  general  system 
improvements  as  their  oresence  ensures  a  smoother  interface 
oetween  the  user  and  the  display  controller.  Of  particular 
concern  in  this  category  are  the  areas  of  system 
initialization  and  error  diagnostics. 
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1.  S  v  s  t  e  m  Initialization 

The  "sysinit"  routine  is  the  first  graphics  routine 
called  within  a  user's  orogram.  The  routine  was  designed  to 
establish  links  from  the  user's  orocess  to  the  Vector 
General  display  unit  so  that  refresh  data  could  be  sent  to 
the  display  unit  and  external  device  information  could  be 
returned  to  the  user.  The  presence  of  two  Vector  General 
display  units  reguired  differentiation  between  units.  The 
user  scecifies  the  desired  disolay  unit  with  the  argument 
oassed  to  the  "sysinit"  routine.  To  insure  maximum 
ooportunity  for  execution  of  a  user's  orogram,  software  was 
added  that  attempts  to  link  a  user  with  the  secondary 
display  unit  should  the  system  be  unable  to  link  to  the 
user's  Drimary  choice.  The  user's  orocess  is  terminated 
only  when  the  system  has  failed  in  attempts  to  link  the  user 
with  both  aisolay  units. 

2,  Error    Diaanostics 

Recognizing  that  users  will  make  errors^  the  design  and 
implementation  of  error  detection  and  recovery  facilities 
was  identified  as  a  necessary  exoense.  The  price  paid  for 
error  detection  and  diagnostics  depends  uDon  the 
sophistication  desired.  The  PL/C  compiler  is  an  example  of 
extremely  forgiving  and  diagnostically  helpful  software. 
Recognizing  that  such  a  system  is  not  cheap  in  terms  of 
reguired  suooorting  software/  the  requirements  for  a 
reasonable  system  of  error  diagnostics  were  reviewed. 

It   was   felt   that   all   detected   errors    should    be 
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identified  to  the  user.  Presentation  of  error  diagnostics* 
however,  is  as  important  as  the  actual  error  detection. 
Cryptic  error  messages  with  numbers  which  must  be  looked  ud 
in  manuals/  do  little  to  help  the  user  diagnose  problems. 
Concise  error  messages  which  identify  the  error?  the  routine 
where  it  occurred/  olus  give  reference  to  additional 
information  were  deemed  more  suitable  and  could  be  obtained 
with  minimal  overhead. 

The  error  diagnostic  routine  was  rewritten  to  provide 
the  user  with  four  items  upon  error  detection.  An  error 
tvoe  is  soecified  so  the  user  may  realize  what  has  caused 
the  error.  Adai t i ona 1  1 y  /  the  argument  in  error  and  the 
routine  in  which  it  occurred  are  specified  to  ensure  that 
the  user  pinpoints  the  oroblem.  Should  the  preceding 
information  be  insufficient/  the  last  item  provided  is  an 
error  number  with  which  the  user  may  obtain  a  detailed 
exolanation  of  the  error  from  the  Vector  General  User's 
Reference  Manual. 

Graceful  error  recovery  could  be  considered  an  art. 
Termination  of  a  user's  program  uoon  initial  error 
detection/  while  easily  accomplishable/  would  tend  to  not 
only  deflate  egos  but  also  discourage  DOtential  users.  All 
software  routines  were  designed  and  implemented  to  detect/ 
identify/  and  "or  ace f u 1  1 y "  recover  from  user  errors. 
Although  the  detection  and  identification  of  errors  is 
fairly  standard  throughout  the  routines/  the  recovery 
methods  vary  from  routine  to  routine.  Within  some  routines/ 
default   oarameters  are       assumed   upon   error   detection  to 
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ensure  continuation  of  the  routine.  Other  instances  may 
occur/  however,  where  no  default  parameter  could  be  assumed. 
In  such  instances  the  only  form  of  recovery  is  to  exit  the 
routine  and-  return  control  to  the  user's  program.  With  the 
exception  of  the  "sysinit"  routine/  no  routine  will  cause 
termination  of  the  user's  orogram.  This  was  done  to  ensure 
that  some  cart  of  the  user's  display  is  oresented/  providing 
the  user  some  amount  of  self-confidence  and  a  starting  point 
for  using  the  error  diaanostics  to  oinpoint  remaining  errors 
in  the  orogram . 
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V.   MODIFICATIONS  TO  SSUNIX  SYSTEM  SOFTWARE 


A.   GENERAL 

Investigation  was  begun  into  the  develooment  of  SSUNIX 
to  further  generalize  the  use  of  other  languages  with  the 
Vector  General  Graphics  Disolav  System.  As  a  result  of  the 
Extended  BASIC  compiler's  inability  to  separate  the 
instruction  and  data  segments  of  an  executable  file/  SSUNIX 
was  imolemented  on  the  PDP-11/50  A  processor  within  the 
Computer  Laboratory.  After  studying  the  UNIX  and  SSUNIX 
systems  and  reviewing  O'Dell's  recommendations  for  final 
integration  with  the  Vector  General  software*  modifications 
were  made  to  complete  the  i mo  1 ement a t i on .  Further 
moaifi cations  were  maoe  when  problems  arose  in  the  SSUNIX 
system  of  core  allocation.  The  modifications  made  to  SSUNIX 
software  were  in  two  general  areas  of  the  system  software. 
Modifications  were  maoe  to  the  SSUNIX  source  code  and  to  the 
Vector  General  device  driver  code. 

O'Dell  C51  implemented  a  segment ed-process  memory 
management  version  of  the  UNIX  operating  system  wnich  was 
previously  develooed  cy  Emery  [31.  O'Dell  also  imolemented 
an  additional  version,  SSUNIX,  which  was  designed  for  a 
shared  memory  environment.  The  UNIX  ©Derating  system  (61, 
from  which  the  above  modified  systems  were  constructed,  is  a 
time-sharing  system  developed   at   Bell   Laboratories.    The 
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UNIX  system  was  currently  in  operation  at  the  Naval 
Postgraduate  School  Computer  Laboratory  on  the  POP-ll/50 
orocessors.  The  notable  accomplishment  of  the  SSUNIX 
operating  system  is  that  it  aligns  a  process's  data  seqment 
or*  combined  data  and  test  segments  into  a  region  of  shared? 
dual-ported  memory.  The  process  image  is  then  locked  in 
this  memory  region  for  execution. 

Prior  to  O'Dell's  accomo 1 i shmen t s ,  Visco  [15]  had 
sugaested  that  Emery's  original  design  was  a  promising 
technique  for  allocating  a  Vector  General  process's  data 
segment  into  a  shared  memory  region.  This  dual-oorted 
memory  region  could  suoseauently  be  accessable  by  a  slave 
processor  which  would  continuously  access  the  display  list 
data  by  DMA  (Direct  Memory  Access).  Visco' s  slave  processor 
design  would  alleviate  the  PDP-11/50  bus  tie-up  problem 
which  was  caused  by  the  high  interruot  precedence  of  a 
refresh  cycle.  The  accessability  of  the  shared  memory 
region  by  the  main  processor  would  provide  the  real-time 
reauirements  for  multiprogramming  in  the  refresh  graphics 
environment.  Visco  believed  that  by  ensuring  only  data 
segments  would  be  located  in  the  32  K  word  shared  core 
region  there  would  be  qreater  efficiency  and  less  likelihood 
of  having  programs  too  large  for  execution. 

A  Key  factor  for  the  implementation  of  SSUNIX  was  its 
propensity  to  distinguish  between  processes  where  data  and 
text  were  separated  segments  in  core  (411  filetypes)  and 
files  where  data  and  text  were  mixed  (407  filetypes). 
SSUNIX  causes  both  filetyoes  to  be  loaded   into   the   shared 
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memory  region  and  executed  alike.  SSUNIX  proved  to  be  the 
solution  to  the  oroblem  of  executing  the  BASIC  executable 
object  module  where  test  and  data  reside  together.  Looking 
beyond  BASIC'S  problems,  SSUNIX  is  of  such  a  general  nature 
that  other  user  languages  can  be  more  easily  implemented 
with  the  Vector  General  software.  The  future  integration  of 
FaP  with  the  SSUNIX  system  should  reguire  no  further 
moafications  to  SSUNIX. 

B.   MODIFICATIONS  TO  SSUNIX  SYSTEM  COOE 


Modifications  to  SSUNIX  were  made  in  two  general  areas: 
the  interface  code  between  the  user  and  the  system  software* 
and  the  correction  of  the  process  for  allocating  core  orior 
to  locking  the  process  in  the  shared  core  region.  These 
changes  were  tested  and  instituted  in  the  SSUNIX  system. 
The  nature  and  exolanations  for  the  changes  are  discussed  in 
the  following  oaragraohs  in  this  section. 

The  first  modification  to  SSUNIX  was  the  updating  of  the 
shared  memory  region  oarameters  located  within  the  "main" 
subroutine  of  the  system.  SSUNIX  is  alerted  by  "getshr" 
that  a  shared  memory  reaion  of  core  is  requested  for 
execution  of  a  orocess.  The  first  oarameter  Dassed  to  the 
system  is  the  region  of  shared  core  that  is  requested. 
These  regions  of  shared  core  are  assigned  the  identifying 
numbers  0  (blocks  2000  -  aOOO)  and  1  (blocks  5000  -  6000). 
Each  block  of  core  reoresents  64  bytes  of  core  soace. 
Region   0  is  32  K  woros  in  size  while  region  1  is  16  K  words 
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in  size.  Region  0  was  originally  declared  as  1000  blocks  in 
length  beginning  at  block  3000.  The  size  of  this  first 
region  had  to  be  corrected  in  SSUNlX's  "main"  routine.  The 
true  size  of  the  region  is  2000  blocks  in  length  beginning 
at  block  2000. 

The  second  modification  to  the  assembly  language  code  of 
" getshr"  was  the  addition  of  a  oarameter  to  be  passed  to  the 
system.  The  Darameter  oassed  is  the  address  of  the  first 
word  of  the  disolay  list.  The  address  represents  the  offset 
value  of  the  first  word  of  the  display  list  from  the 
beginning  of  the  data  segment.  If  the  text  and  data 
segments  are  not  solit*  the  offset  is  from  the  beginning  of 
the  mixed  text  and  cata.  This  method  identifies  the  first 
word  of  the  disolay  list  to  the  device  driver  whether  or  not 
text  and  data  were  solit.  If  I  &  D  space  were  split  and 
"vgdata"  was  included  at  the  beoinning  of  the  C  program^  the 
offset  would  be  zero  indicating  that  the  display  list  starts 
at  the  beginnina  of  the  process's  data  space.  Iff  as  in  a 
BASIC  process*  I  &  D  soace  were  not  solit  the  offset  would 
be  added  with  the  offset  of  the  data  segment  from  the 
beginning  of  the  shared  memory  region. 

Prior  to  the  inclusion  of  the  offset  address  in  tne 
"aetshr"  routine*  both  "getshr"  and  "freeshr"  had  to  be 
introduced  into  the  Vector  General  Library.  The  previous 
calls  to  "rtime"  and  "nonrtime"  under  the  UNIX  system  were 
changed  to  "getshr"  and  "freeshr"  calls.  The  difference  was 
that  the  shared  memory  configuration  of  core  required  the 
Vector  General  orocesses  to  reauest  this  shared  core   region 
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for  loading  and  execution. 

In  order  to  use  the  offset  value  oassed  to  the  system  bv 
the  "getshr"  call ,  a  small  routine  called  "vgdsoff"  was 
added  to  SSUNIX.  Ahen  "getshr"  is  called  by  the  Vector 
General  user  code/  a  new  variable  "firstwdaddr"  is  assigned 
the  value  of  the  the  offset  of  the  first  word  of  the  display 
list.  The  "vadsoff"  routine  returns  the  value  of 
"firstwdaddr"  to  a  calling  routine  in  the  device  driver. 
The  only  routine  that  would  call  for  this  value  would  be 
"vgdev50.c"  which  is  the  PDP-11/50  device  driver  for  the 
Vector  General  Oisolay  Processor.  This  offset  value  passed 
to  the  driver  code  is  a  key  factor  in  allowing  various  user 
languages  to  use  the  Vector  General  software.  without  this 
offsets  the  ability  to  generalize  the  refresh  method  for 
different  languages  would  be  difficult. 

The  final  modification  to  the  SSUNIX  system  was  the 
result  of  a  condition  that  had  previously  gone  unnoticed. 
With  the  helo  of  Q'Dell*  the  source  of  an  error  in  core 
allocation  by  SSUNIX  was  traced  to  a  routine  called 
"""alloc".  This  routine  allocates  soace  in  core  to  the 
orocess  being  loaded  by  first  checking  the  core  "free  map". 
The  "free  map"*  which  is  a  mappinq  of  free  core  areas,  keeps 
track  of  the  areas  of  core  which  are  free  to  be  used  for 
storage  of  a  Drocess.  SSUNIX  first  swaos  a  process  out  of 
core  onto  disk.  The  orocess  is  then  copied  back  into  core 
in  an  area  not  within  the  shared  memory  region  so  it  is  out 
of  its  own  wav.  "^alloc"  failed  to  take  into  account  that  a 
large  free  core  area  could  exist  from  just  below   the   upoer 
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address  of  the  shared  memory  region  to  the  too  of  available 
core  area.  If  the  area  beneath  the  shared  core  region  was 
not  large  enough  to  store  the  process,  the  next  free  area  to 
be  checked  would  d  e  this  large  area .  This  area  was 
unavailable  for  storage  as  the  set  flag  "sharflg"  indicated 
the  region  was  in  the  shared  memory  region.  As  the 
beginning  of  the  area  was  located  in  the  shared  core  region, 
the  entire  area  was  marked  unavailable  for  process  swapping. 

A  routine  called  "solitmap"  was  designed  ana  implemented 
to  remedy  the  problem  by  updating  the  core  "free  map"  to 
reflect  that  the  region  above  the  upper  boundary  of  the 
shared  core  was  available  for  storage.  "Splitmap"  is  called 
in  the  "shalloc"  routine  just  prior  to  a  call  to  "ceswap". 
"Ceswap"  originally  called  the  "malloc"  routine  to  assign 
the  core  area  for  temporary  storaae.  "Splitmap"  changes  tne 
representation  of  the  free  core  region  to  two  free  core 
regions  which  would  be  separated  by  the  upper  boundary  of 
the  shared  core  region.  The  area  within  the  shared  core 
region  would  not  be  used  due  to  the  set  "sharflg",  while  the 
area    above  the  boundary  would  be  Droperly  allocated. 

Other  core  allocation  conditions  were  reviewed  to 
determine  if  additional  problems  could  arise.  No  other 
problems  were  noted,  and  the  updated  version  of  SSUNIX  was 
found  to  function  orooerly. 
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C.   MODIFICATIONS  TO  DEVICE  DRIVER  CODE 

As  previously  mentioned,  the  device  driver  code  for  the 
Vector  General  was  modified  to  allow  the  execution  of 
orocesses  with  or  without  split  text  and  data  segments. 
Visco  designed  the  original  device  drivers*  "nvgdev34.cw  and 
Hnvgdev50.c"»  to  support  the  Vector  General  in  a  multi- 
processor mode  of  operation.  The  two  processors  were  to 
interact  in  refreshing  and  updating  the  Vector  General 
display  list.  Inherent  in  the  design  was  the  assumption 
that  all  processes  would  be  of  the  411  filetyoe,  where  text 
and  data  segments  are  separated.  The  data  segment  would  be 
located  alone  in  the  sharaole  core  region.  In  order  to 
discuss  the  modifications  to  the  drivers,  a  brief 
description  of  each  driver  is  presented. 

The  "nvgdev34.c"  driver  is  the  proposed  PDP-11/34 
resident  device  driver  for  the  Vector  General.  It 
communicates  to  the  PDP-11/50  by  messages  that  are  passed 
througn  a  hardware  interface  device  called  the  DR-ll-K.  The 
driver  is  passed  several  items  of  important  information  by 
the  message  orocess:  the  offset  of  D  soace  within  the  shared 
memory?  the  use  of  Vector  General  numbers  0  or  1?  and,  the 
time  to  begin  refreshinq  the  display  list.  This  driver  is 
also  responsible  for  handling  the  interrupts  generated  by 
the  Vector  General  display  controller. 

The  Hnvgdev50 .c "  driver  is  the  PDP-11/50  processor 
resident  device  driver  that  supports  the  Vector  General  in 
the  two  processor   mode.    This   driver   formats   and   sends 
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messages  to  the  PDP-11/34  processor  through  the  DR-ll-K 
device.  The  messages  sent  by  this  driver  designate  the 
offset  of  the  data  space  *rom  the  beginning  of  the  32  K  word 
shared  memory  region  to  determine  where  the  disolay  list 
begi  ns  in  core . 

The  temoorary  device  drivers*  "tvgdev34.c"  and 
Htvgdev50.c"/  were  designed  to  suoDort  the  Vector  General  in 
a  single  processor  moae.  The  two  drivers  were  originally 
written  by  Visco  to  simulate  and  test  the  operation  of  the 
two  processor  design  until  the  PDP-11/34  orocessor  could  be 
installed.  Both  te^pory  device  drivers  will  continue  to 
drive  the  Vector  General  until  the  slave  processor  is 
integrated  into  the  system. 

The  drivers  were  cesigned  with  two  goals  in  mind.  The 
first  goal  has  been  discussed  before.  The  PDP-11/34  driver, 
as  the  refresh  orocessor*  would  refresh  the  display  list. 
The  second  design  goal  was  that  the  PDP-11/50  driver  had  to 
inform  the  slave  orocessor  of  the  location  of  the  display 
list  for  refreshing  purposes.  In  generalizing  the  driver 
code  these  two  goals  remained  oreeminent.  The  following 
oaragraohs  document  the  exact  modifications  made  to  the 
device  drivers  currently  used  under  the  SSL) NIX  operating 
system . 

1.   Modifications  to  TVGDEV50.C 

Only  one  addition  was  made  to  this  driver.    Within  the 

"vgooen"   routine*   a   check   was  made  to  determine  if  I  &  D 

soace  was  solit.   If  it  was   not   split*   indicating   a  407 
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process,  a  message  was  sent  to  the  34  device  driver  which 
Dassed  the  offset  of  the  first  word  of  the  display  list  from 
the  oeginning  of  the  process.  The  message  was  distinguished 
in  the  34  driver  from  other  messages  by  virtue  of  its  sign 
bit  being  set.  The  messaae  was  constructed  by  setting  the 
sign  bit  for  the  value  returned  from  the  previously 
develooea  "vgdsoff"  routine  within  SSUNIX.  A  return  to  the 
50  driver  was  made  after  the  message  was  processed  by  the  34 
driver.  The  use  of  the  messages  in  the  34  driver  will  be 
discussed  in  the  following  section. 

2.   Modifications  to  TVGDEV34.C 

The  functioning  of  the  34  device  driver  depends  on  the 
information  oassed  to  it  by  the  50  device  driver.  Several 
modifications  had  to  be  made  to  the  driver  to  generalize  the 
code  for  additional  language  implementation.  The  first 
modification  was  the  crocessing  of  the  offset  message  passed 
by  the  50  driver  in  cases  where  I  4  0  soace  was  not  split. 
This  message  is  received  by  the  "vg34com"  routine  and  is 
converted  to  a  positive  value.  A  new  variable* 
H sha rmemo f f " »  is  set  to  the  Dassed  value.  The  value  of 
■ sharmemo f f "  remains  zero  if  a  411  process  is  executed 
because  the  variable  had  oreviously  been  initialized  as  zero 
and  no  additional  message  would  have  been  passed  to  the 
driver.  If  the  variable  had  a  oositive  value,  indicating  a 
407  process,  the  item  would  be  used  in  the  "vaopen"  routine 
located  within  the  driver  code.  Three  seoarate  variables 
depend  on       this   variable   for   determinina  values  that  tne 
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refresh  cycle  and  the  PDP-11/34  memory  management  operation 
are    Dased  on . 

The  PDP-11/34  is  unable  to  address  items  in  a  user's 
display  list  by  simoly  referencing  symbol  names.  It  is  able 
to  address  only  the  32  K  words  of  the  dual -ported  shared 
memory.  By  using  the  memory  management  hardware  and  the 
message  information  passed  by  the  50  driver,  the  correct 
physical  addresses  of  the  display  Hst  items  can  be  located 
in  core.  The  oage  address  registers,  when  properly  set/ 
allow  this  maoping  or  conversion  of  virtual  to  physical 
addresses  in  core  til. 

Three  variables  called  "vgpar",  "vgreal",  and  "pp"  all 
involve  the  use  of  memory  management.  The  "op"  variable  is 
a  virtual  address  pointer  that  can  be  used  in  addressing  any 
item  in  the  display  list  which  resides  in  the  shared  memory 
region  of  core.  This  variable  can  be  used  to  address  uo  to 
1  K  words  of  core  which  is  more  than  adeauate  for  addressing 
the  several  hundred  words  in  the  display  list  that  miaht  be 
addressed . 

The  result  of  the  modifications  made  to  this  device 
driver  was  the  correct  refreshing  of  both  407  and  411 
filetyoe  processes.  All  other  added  items  within  this 
driver  reflect  additional  interrupt  handling  capabilities 
for  the  external  devices  of  the  system. 
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VI.   CONCLUSIONS  AMD  RECOMMENDATIONS 


The  primary  objective  of  work  described  in  this  thesis 
was  the  implementation  of  enhanced  user  software  with  the 
Vector  General  Display  System.  This  objective  was  attacked 
on  two  fronts.  The  first  aDoroach  was  to  test,  correct,  and 
exoand  the  software  creviously  available  on  the  system, 
which  would  improve  user  interaction.  The  second  approach 
was  to  implement  other  user  lanquages,  specifically  versions 
of  BASIC  and  FORTRAN,  with  the  Vector  General  software. 
Together,  the  two  approaches  provided  the  successful 
implementation  of  a  oackage  which  better  supports  user 
interaction  with  the  Vector  General  Display  System.  This 
chapter  orovides  further  recommendations  to  improve  the 
system  in  the  areas  of  the  display  list  design,  language 
development,  and  system  software  implementation. 

A.   DISPLAY  LIST  DESIGN 

In  the  present  design  of  the  Vector  General  software,  a 
structure  within  the  display  list  is  utilized  to  store  user 
commands  to  De  executed  on  the  Vector  General  display.  This 
structure  "vgalbuf"  is  of  a  fixed  length,  4  K  words  of  the 
shared  memory.  An  improvement  in  this  techniaue  of  havina  a 
fixed  length  display  list  could  be  investigated.  One 
oossibility  would   be   the   implementation   of   software   to 
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increase  the  size  of  the  structure  which  would  utilize  the 
unused  oortion  of  the  sharable  memory  region.  This  software 
implementation  would  be  useful  when  no  other  process  needs 
the  shared  memory  region  and  the  parent  process  requires 
additional  core  space. 

B.   LANGUAGE  DEVELOPMENT 

F4P  (FORTRAN  iV-Plus)  was  not  completely  implemented 
with  the  Vector  General  software  due  to  problems  encountered 
with  the  interaction  between  the  F  4  P  and  C  languages.  It  is 
recommenced  that  investigation  continue  in  reconciling  the 
"overlay"  oroblem  caused  by  C  converted  subroutines  having 
more  than  one  copy  of  globally  declared  variables. 
Prereauisite  to  understanding  this  problem  is  the 
acquisition  of  source  code  and  documentation  for  the  F4P 
compiler,  the  "  c  o  n  v  "  subroutine,  and  the  F  4  P  "linker". 
Completion  of  the  the  F4P  and  C  interface  would  further 
exoand  the  utilization  of  the  Vector  General  Graphics  System 
to  users  with  knowledge  of  other  languages. 

The  inability  of  Robertson's  BASIC  compiler  to  split  I  & 
D  soace  is  viewed  as  a  less  important  problem.  SSUNIX  and 
driver  desian  modifications  were  implemented  to  overcome 
execution  problems  of  the  BASIC  Vector  General  programs. 
The  expense  of  BASIC'S  inability  to  SDlit  text  and  data 
segments  reguired  the  allotment  of  more  shared  memory  in 
loading  the  combined  text  and  data  segment.  By  re-working 
the   compiler   to   allow   the   stacking   of  data  and  text  in 
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seoarate  data  and  text  segments,  more  comolex  BASIC  programs 
could  be  executed  in  the  shared  core  region  allotted  for 
execution.  Additional  testina  of  large  BASIC  programs  could 
helo  determine  the  limitations  of  loading  both  text  and  data 
segments  into  the  shared  memory  region. 

C.   SYSTEM  SOFTWARE  IMPLEMENTATION 

An  increasing  item  of  importance  to  the  software 
developed  in  this  thesis  and  previous  software  work  is  the 
continuing  support  of  the  SSUNIX  operating  system  in  the 
Naval  Postgraduate  School  Graphics  Laboratory.  It  is 
recommended  that  increasing  emphasis  and  testing  be  placed 
on  SSUNIX  while  running  in  a  day-to-day  operational 
environment  to  ensure  its  reliability. 

The  implementation  of  the  PDP-11/34  processor  in  a 
oua 1 -orocesso r  mode  with  the  PDP-11/50  processor  should  be 
of  primary  importance  for  the  Vector  General  Display  System 
to  alleviate  the  current  bus  tie-up  oroblem.  An 
investigation  into  the  communication  reauirements  between 
the  slave  and  the  master  processors  should  be  conducted. 
The  hardware  interfaces  for  the  32K  word  shared  core  region 
and  the  Vector  General  display  device  should  also  be 
i  mo  1 emen  ted. 
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APPENDIX  A 
USER'S  REFERENCE  MANUAL 

The  ouroose  of  this  document  is  to  Drovide  the  user  with 
the  information  necessary  to  execute  programs  employing  the 
Vector  General  graphics  display.  This  manual  was  originally 
prepared  by  B.  J.  Stankowski  in  June  1976  and  revised  by  N. 
P.  Martino  and  0.  C.  Endicott  in  December  1977. 

Section  I  provides  a  brief  introduction  to  the  Vector 
General  display  system/  the  software  support  library,  and 
the  preregu i s i t es  for  their  effective  utilization.  Section 
II  descrioes  the  Vector  General  system  in  more  detail* 
expanding  upon  the  hardware  features?  system  interface/  and 
external  device  capabilities.  Section  III  contains 
information  on  the  initialization  of  the  Vector  General 
display  system.  Section  IV  describes  the  display 
composition/  element  construction/  and  picture/  object/  and 
element  relationships.  Section  V  provides  a  brief 
description  of  the  user  suooort  routines  available  in  the 
supoort  library.  Finally/  Section  VI  provides  information 
necessary  for  compiling  and  executing  user  programs 
employing  t^e  Vector  General  graphics  display  unit. 
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I.   INTRODUCTION 


The  Vector  General  is  an  interactive  graphics  display 
system  which  has  been  interfaced  with  the  PDP-11/50 
comouter.  The  display  interacts  with  a  PDP-11  user  by 
disDlaying  d  i  c  t  o  r  i  a  1  information  on  the  surface  of  a  cathode 
ray  tube  and  by  accepting  information  from  its  external 
control  devices.  The  external  devices  consist  of  an 
alphanumeric  keyboard*  32  lighted  function  switches*  10 
control  dials*  a  trackball*  a  joystick*  and  a  lightoen. 

An  interactive  graphics  software  orogram  library  has 
been  constructed  to  interface  the  user  and  the  Vector 
General  aisolav  controller.  The  software  package  provides 
the  user  witn  sufficient  routines  to  easily  construct  and 
•naniDulate  graohic  displays.  Although  the  routines  were 
written  in  C*  the  user  has  the  choice  of  two  high-level 
languages  with  which  to  orogram.  BASIC  programs  may  now 
also  interface  with  the  Vector  General  through  the  use  of 
the  routines  in  the  software  suDOort  library. 

This  manual  does  not  attempt  to  discuss  in  detail  the 
electronic  functions  of  the  Vector  General*  or  its  interface 
with  the  PDP-11.  The  ouroose  of  this  manual  is  to  instruct 
a  user  in  the  creation  and  "lanioulation  of  pictorial  data  on 
the  Vector  General  display.  A  knowledge  of  C  or  Basic  is 
assumed . 
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II.   THE  VECTOR  GENERAL  DISPLAY  SYSTEM 


A  more  detailed  discussion  of  the  Vector  General  can   be 

found   in   the   Users   Manual  for  the  Vector  General  Display 

Unit  [121  and  the   Design   Manual  for   the  Vector  General 
Di  spl av  Uni  t  [11] . 

A.   THE  DISPLAY 

The  Vector  General  is  a  cathode  ray  tube  (CRT)  display 
on  w  n  i  c  h  a  visible  oattern  can  be  created  dv  the  movement  of 
an  electron  beam.  The  electron  beam  causes  a  florescent 
SDot  to  aooear  on  the  face  of  the  display  tube.  The 
movement  of  the  beam  is  controlled  by  a  method  called  random 
scan,  which  in  effect  steers  the  spot  in  a  straight  line 
Between  two  points  on  the  display  screen.  The  resulting 
line  or  vector,  combined  with  others,  creates  a  picture  or 
oattern  on  the  display  screen. 

To  maintain  a  clear  oicture  on  the  disolay  screen 
reguires  that  the  oattern  be  redrawn  on  the  tube  repeatedly 
at  aporox i ma t e 1 y  thirty  to  forty  times  a  second.  Each 
repetition  is  called  a  frame  and  the  frequency  with  which  it 
is  redrawn  is  called  the  refresh  rate.  If  the  oattern  is 
not  reoeated  often  enough  a  degradation  of  the  picture  will 
occur  on  the  display  screen.  This  degradation  is  called 
f  1  icxer. 
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B.  HARDWARE  FEATURES 

The  system  has  several  hardware  features*  in  addition  to 
a  vector  generator,  which  greatly  extend  its  capabilites. 
These  include  the  ability  to  produce  three-dimensional 
figures*  an  ASCII  character  set*  and  the  hardware  generation 
of  arcs  and  circles.  Other  features  orovide  the  hardware 
mechanisms  for  the  rotation  and  translation  of  user 
soecified  picture  segments.  These  hardware  features  are 
controlled  ana  coordinated  by  the  disolay  controller.  The 
controller  is  resoonsible  for  handling  the  communications 
between  the  user*  the  external  control  devices  and  the 
disolay  hardware . 

The  main  purpose  of  the  external  control  devices  is  to 
facilitate  user  interaction  with  the  disolay.  These  devices 
include  an  alohanumeric  keyboard*  32  lighted  function 
switches*  10  control  dials*  a  trackball*  a  joystick*  and  a 
light  oen . 

Additional  information  on  the  Vector  General  hardware 
can  be  found  in  the  Graohics  Disolay  peference  Manual  [13] 
and  the  Graohics  Disolay  System  Technical  Manual   1 1 4 J  . 

C.  THE  SYSTEW  INTERFACE 

A  Vector  General  user  defines  pictorial  data  and  its 
manioulation  within  a  Basic  or  C  oroqram.  The  execution  of 
the  orogram  causes  the  Vector  General  software  interface  to 
be  activates.  It  is  this  software  which  communicates  user 
requests  and  receives  information  from   the   Vector   General 
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controller.  The  software  oasses  user  requests/  in  the  prooer 
form,  to  the  diol ay  controller.  The  controller  will 
activate  the  Drooer  hardware  generator  (ie.  character, 
vector,  '  arc/circle)  which  will  output  the  desired 
information  on  the  diDlay  screen.  The  controller  will  also 
oass  information  from  the  external  control  devices  back  to 
the  user  via  the  interface  software.  This  relationship  is 
illustratea  in  figure  A-l. 
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Interface  Relationshio  with  the  Vector  Genera 

FIGURE  A-l 


D.   INTERFACE  «ITH  EXTERNAL  DEVICES 

Each  of  the  the  external  devices  communicate  directly  to 
the  Vector  General  controller.  Information  from  tnese 
devices  is  returned  to  the  user  via  the  controller  and  the 
user  interface.  The  user  oroqram  may  utilize  the  information 
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returned  from  these  devices  to  control  program  flow.  This 
allows  a  user  to  interactively  control  and  manipulate  the 
pictorial  information  at  display  time.  Soecific  user 
routines  which  activate  these  external  devices  and  provioe  a 
communications  channel  with  the  user  are  discussed  in  detail 
in  later  sections  of  this  manual. 

1.  Alphanumeric  Keyboard 

The  alphanumeric  keyboard  allows  the  user  to  input 
information  in  the  form  of  ASCII  character  codes.  Through 
the  user  interface  the  user  can  display  the  information  on 
the  Vector  General  display  screen.  The  data  entered  from 
the  keyboard  can  also  be  returned  to  the  user  program  for 
orocess  i  ng . 

2.  Function  Switches 

The  32  lighted  function  switches  provide  the  user 
with  information  which  can  be  used  to  interactively 
manipulate  pictorial  data  at  oiSDlay  time.  Each  function 
switch  can  be  assignee  specific  meaning  by  the  user  program. 
The  user  interface  returns  to  the  user  information  on  which 
function  switches  have  been  pressed.  A  user  program  could 
use  this  information  to  selectively  rotate/  translate  or 
Derhaos  scale  particular  picture  segments. 

3  .   Con  t  ro 1  Dials 

The  10  control  dials  provide  numeric  information  to 
the  disolav  controller,  soecifying  the  degree  to  which  each 
dial   has   been   turned.    This   information,   through    the 
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software,  can  be  orovidea  to  the  user.   A  user   program  mav 

utilize    the   values   of   the   variable  control   dials  in 

determining  the  distance  or  rate  at  which  a  Dortion  of  the 
oicture  may  be  moved  or  rotated, 

a.   Trackbal 1 

The  trackball  is  an  external  device  which  uses  a 
software-generated  blinking  cursor  to  provide  visual 
positioning  feedback  to  the  user.  The  rolling  action  of  the 
user's  hand  across  the  round  trackball  steers  the  cursor 
about  the  display  screen.  A  routine  is  available  to  return 
the  trackball  cursor  position  within  the  defined  coordinate 
system  so  the  user  may  orogramatically  use  this  information. 
Addi t i ona 1 1 y t  a    routine   is   available   to   activate   or 

deactivate  the  disolav  of  the  software-generated  cursor. 
Positioning  information  may  be  returned  to  the  user  whether 
or  not  the  cursor  is  displayed. 

5 .   Joys t  i  c  k 

The  joystick  is  an  external  device?  which  like  the 
trackball,  uses  a  software-generated  blinking  cursor  to 
provide  positioning  feedback  to  the  user.  Unlike  the 
trackball  which  moves  about  only  the  X-Y  plane,  the  joystick 
cursor  appears  to  move  in  three  dimensions.  Movement  about 
the  X-Y  plane  is  accomplished  by  pushing  the  joystick  fore- 
aft,  and  s i de- 1 o-s i ce  .  Movement  along  the  Z  axis 
(perpendicular  to  the  disolay  screen)  is  accomplished 
manually  Oy  twisting  the  knob  on  top  of  the  joystick  and 
visually   on  the  screen  by  using  the  deoth-cueing  facilities 
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and  varying  the  cursor  intensity.  Like  the  trackball/ 
routines  are  available  to  return  to  the  user  the  joystick 
cursor  oosition  and  activate  or  deactivate  the  display  of 
t  he  cursor . 

0.   Lightoen 

The  lightoen,  a  wand  containing  a  photo  cell*  can  be 
used  to  selectively  point  to  different  picture  segments  on 
the  display  screen.  The  interface  provides  a  user  crogram 
with  information  on  which  oicture  segment  was  pointed  to  by 
the  lightoen.  A  user  program  can  turn  the  lightpen 
se 1 ec t ab i 1 i t y  of  specific  picture  seaments  on  or  off.  For 
example/  a  user  might  select  sections  of  a  picture  for 
erasure  by  pointing  to  them  with  the  lightoen. 

The  software  additionally  orovides  for  generation  of  a 
lightoen  cursor.  The  lightpen  cursor  is  a  small  non- 
blinking  octagon  which  mav  be  moved  about  the  display  screen 
with  the  lightpen.  Two  soeeds  of  lightpen  movement  are 
availaole.  Routines  for  returning  the  lightpen  cursor 
position  and  activation/deactivation  of  the  cursor  display 
are  available  within  the  software  oackaae. 
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III.   INITIALIZATION 


A.   INTERFACE  INITIALIZATION 

The  Vector  General  display  system  and  the  graphics 
software  with  the  PDP-11  must  be  initialized  before  any  data 
can  be  displayed.  The  initialization  routine  sysinit  must 
be  called  before  any  other  routines  are  utilized.  This 
routine  sets  all  the  system  default  oarameters/  such  as  the 
screen  coordinate  system. 

If  for  some  reason  the  initialization  cannot  be 
comoleted  tne  user  crogram  will  be  terminated.  This  error 
usually  occurs  because  another  user  is  accessing  the  Vector 
Genera  1  . 

8.   DISPLAY  INITIALIZATION 

1.   Coordinate  System 

The  user  can   soecify   a   two   or  three-dimensional 

cartesian   coordinate  system.   All  display  coordinate  values 

referenced  by  the  user  will  be  interpreted  according  to  this 

coordinate  system  definition.  A  user  may  redefine  the 
coordinate  scale  at  any  time  in  a  program.  The  user  will 
define  the  coordinate  system  in  a  call  to  the  routine 
coordsy s . 

COOrdsys(dim,minx,maxx>miny,maxy  f/minzrmaxz] )/ 


65 


The  routine  reauires  the  user  to  specify  if  the 
coordinate  system  is  to  be  two  or  three-dimensional  and  the 
range  of  each  coordinate.  If  the  oarameter  'dim'  is  two, 
indicating  a  two-dimensional  coordinate  system  is  desired, 
the  range  of  the  z  coordinate  can  be  omitted,  and  will  be 
ignored  if  it  should  be  included. 

If  this  routine  is  not  called  by  the  user  the  default 
coordinate  system  will  be  used.  This  default  system  is 
defined  as  three-dimensional  with  the  x,  y,  z  coordinates 
ranging  from  -100.0  to  100.0.  All  coordinate  values  will  be 
interpreted  by  this  default  system  when  coordsys  is  not 
called  by  the  user. 

As  will  be  discussed  later  in  this  manual,  both  absolute 
and  relative  vectors  may  be  utilized  in  constructing  display 
elements.  Should  an  absolute  coordinate  be  soecified  which 
falls  outside  the  aefined  coordinate  system,  a  value  of  the 
nearest  coordinate  within  the  defined  system  will  be 
assumed.  Should  a  relative  increment  be  specified  which 
exceeds  one-half  the  coordinate  range  (ie:  100  for  default 
coordinate  system)  a  value  of  zero  will  be  assumed. 

2.   Picture  Scale 

The  rectangular,  13  by  14  inch,  portion  of  the 
display  screen  that  can  be  viewed  by  the  user  is  called  the 
visible  space.  The  maximum  Dicture  space  is  larger  than  the 
visible  soace,  covering  an  area  of  30  by  30  inches.  This 
extra  area  allows  a  user  to  rotate  or  move  oart  of  the 
picture   to   the   extreme   boundaries   of   the  visible  space 
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without  any  distortion.  It  also  d  e  r  m  i  t  s  limited  zooming. 

The  pictorial  data  being  displayed  can  be  adjusted  in 
size*  or  scaled*  by  two  different  controls.  One*  the  gain 
control  dials  on  the  Vector  General  display  unit  allow  the 
user  to  manually  manipulate  the  picture  scale.  The  second 
provides  scale  control  within  the  user's  program  by  calling 
the  routine  oscale.  This  routine  is  discussed  in  detail  in 
Section  V  of  this  manual. 
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IV.   CREATING  A  PICTURE 


A.   PICTURE  STRUCTURE 

AH  of  the  information  that  a  user  desires  to  display  on 
the  Vector  General  must  be  incorporatea  into  the 
hierarchical  oicture  structure  defined  by  the  interface 
software.  The  three  hierarchical  levels  are  defined  as: 
picture*  object/  element.  These  levels  specify  the 
underlying  structure  of  the  graphical  display  and  determine 
the  ooerations  a  user  can  Derform  on  information  associated 
with  eac  h  level. 

The  term  oicture  refers  to  all  of  the  data  that  is  to  be 
disolayed  on  the  Vector  General  display  SDace.  The  term 
element  refers  to  the  smallest  oicture  segment  which  can  be 
i ndeoenden t 1 y  referenced  and  changed  without  affecting  the 
remainder  of  the  oicture.  Each  element/  or  independent 
picture  segment/  has  a  unioue  name  associated  with  it.  A 
collection/  or  meaningful  grouping/  of  elements  is  called  an 
object.  Each  object  is  also  labeled  by  a  unioue  name  so  it 
can  oe  easily  referenced  by  a  user.  Figure  A-2  illustrates 
the  relationshio  of  the  three  levels  in  the  actual  structure 
of  a  oicture. 

An  element  is  completely  described  and  named  by  the 
user.  It  can  describe  either  graohical  or  ASCII  character 
data.   An  element  can  be  i ndeoenden t 1 y  added   or  erased  from 


68 


PICTURE 


r 

OBJECTl      OBJECTS      OBJECT5 


&a>Ynp\e  *  1. 


/ 


/ 


/ 


/ 


/W       /\ 

'      \     \    \ 


ELE^ENTl     ELEVENT2     ELEMENT3     ELEMENTS 


Exampte*! 


Hierarchical  Picture  Structure 
FIGURE  A-2 


69 


the  display  screen.  It  can  be  caused  to  blink  or  be 
soecified  as  being  liqhtpen  selectable. 

Each  element  must  be  associated  with  at  least  one  object 
Before  it  can  be  displayed  on  the  Vector  General.  An  object 
may  consist  of  from  one  to  ten  elements.  A  user  is 
resDonsible  for  establishing  the  desired  ob j ec t -el ement 
association,  and  for  specifying  a  unique  name  for  each 
object.  Each  user  oefined  object  can  be  independently 
rotated,  or  translated  to  any  section  of  the  30  by  30  inch 
disDlay  soace.  An  object  can  be  added  or  erased  from  a 
picture,  scaled,  and  SDecified  to  blink  or  to  be  lightoen 
selectable.  Each  object's  intensity  can  be  varied  in  order 
to  give  three-dimensional  objects  their  depth  gueuing.  These 
actions,  when  aDplied  to  a  SDecific  object,  affect  every 
element  that  has  been  associated  with  it  by  the  user. 

A  picture  may  contain  from  one  to  ten  objects.  The 
coordinate  scale  anc  picture  scale  defined  by  the  user 
affects  t*e  entire  oicture.  A  Dicture's  coordinate  scale 
can  be  varied  but  this  action  will  affect  every  object 
defined  as  oart  of  the  oicture.  An  entire  oicture  can  also 
be  erased,  soecified  to  blink  or  be  lightoen  selectable. 

A  summary  of  the  operations  for  each  level  of  the 
hierarchy  is  out  1  inea  in  Figure  A-3. 
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FIGURE  A-3 


B.   CONSTRUCTING  AN  ELEMENT 

Every  element  is  comoletely  described  by  the  user  within 
an  element  block.  There  are  two  tyoes  of  element  blocks.  A 
araw  element  block  describes  graphical  information.  A 
character  element  describes  ASCII  characters  that  are  to  be 
disolayed.   Each  element  is  uniauelv   named   and   this   name 
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will  be  used  to  reference  this  particular  structure. 

1.   Draw  Element  Block 

A  draw  element  block  represents  a  group  of  draw 
instructions  that  describe  a  soecific  structure*  or  picture 
segment.  These  draw  instructions  include  setvector,  move/ 
line*  arc  and  circle.  A  draw  element  block  begins  with  a 
call  to  the  routine  drawele  and  is  terminated  by  a  call  to 
the  routine  endele.  The  draw  instructions  that  are  executed 
between  drawele  and  enoele  describe  the  actual  oicture 
segment . 

The  only  oarameter  reguired  by  drawele  is  a  quoted 
character  string,  or  pointer  to  a  character  string, 
soecifying  the  name  the  user  wants  to  associate  with  this 
element.  This  name  will  be  used  throughout  the  program  to 
reference  this  element  block. 

The  basic  draw  element  block,  and  the  related  draw 
instructions  are    represented  in  the  following  format: 


drawel e  (  "  e  1 ement-name") ; 

setvector(vtyce,vmpde,  Cine]  ,  [scale]  ) t 


•setvector(vtyoe,vmooe,  fine]  ,  [scale]  ); 

move ( x  ,  [y]  >  [  zl  )  'i 

1  i  ne ( x  ,  [y  ]  ,  [z J  ) ; 

circle(dir,centx,  (centyl  ,  [cent  zl  ); 
-    arc(dir,centx,  (centyl  ,  fcentzl  ,endx,  (endyl  ,  tendz]  ); 


---    enGe 1 e ( ) ) 


The  user  can  select  one  or  more  of  twelve   vector   tyoes 
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in  constructing  an  element.  These  vector  types  describe  how 
the  coordinate  data  will  be  interpreted  in  drawing  a  vector 
on  the  display  screen.  The  choice  of  a  vector  effects,  the 
parameters  that  will  be  passed  in  each  of  the  move*  line/ 
circle  or  arc  instructions.  The  user  specifies  a  vector 
selection  py  calling  the  routine  setvector. 

a .   Set vec  tor 

This  draw  instruction  must  be  called 
immediately  after  drawele/  and  mav  be  called  any  number  of 
times  within  the  element  block.  Each  setvector/  and  the  draw 
instructions  that  follow  it/  comprise  a  subgroup.  The 
setvector  instruction  determines  the  manner  in  which  the 
line/  move/  arc  and  circle  instructions  in  the  subgroup  will 
be  interpreted/  as  well  as  their  visual  apoearance  on  the 
aisolay  screen.  The  routine  is  called  with  the  followina 
paramet  e  rs : 

setvectorCvtyoe/vmode  C  /  i  n  c  1   t/scalej); 

The  carameter  vtyce  specifies  which  one  of  the  twelve 
vector  types  trie  user  wants  the  following  group  of  line/ 
move/  arc  and  circle  instructions  to  utilize.  The  parameter 
vmode  indicates  the  vector  mode/  or  aopearance  of  the 
vectors  to  be  drawn  (ie/  solid  line/  dotted  line/  etc.). 
Certain  vector  tyoes  reauire  additional  information;  this 
information  is  specified  by  the  parameters  i nc  and  scale. 

A  prief  summary  of  the  twelve  vector  tyoes  is  listed  in 
Tao 1 e  A-I . 
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TABLE  A-I 
SUVARY  OF  VECTOR  TYPES 


NAME  DESCRIPTION 

vA   -  vector  absolute;  each  coordinate  is  soecified 
with  resoect  to  the  origin.   Each  point(x,y,z) 
references  a  uniaue  ooint  on  the  display  screen. 

VAX  -  vector  absolute  auto-increment  x;  every  draw 
instruction  causes  the  y  and  z  absolute 
values  to  be  uooated  while  x  is  stepped  by  a 
const  ant  value. 

VAY  -  vector  absolute  auto-increment  y;  every  draw 
instruction  causes  the  x  and  z  absolute 
values  to  be  updated  while  y  is  stepped  by  a 
constant  value. 

VAZ  -  vector  aosolute  auto-increment  z)     every  draw 
instruction  causes  the  x  and  y  absolute 
values  to  be  uooated  while  z  is  stepped  by  a 
constant  value. 

VR   -  vector  relative;  each  %,    y,  z  coordinate 
value  indicates  the  amount  that  is  to  be 
added  or  subtracted  from  the  previous  absolute 
coordinate  point. 

VRX  -  vector  relative  auto-increment  xi     each  draw 

instruction  causes  the  y  and  z  coordinate  values 
to  be  incremented  by  the  soecified  value  while 
x  is  steooed  by  a  constant  value. 

y R Y  -  vector  relative  auto-increment  y ;  each  oraw 

instruction  causes  the  x  and  z  coordinate  values 
to  be  incremented  bv  the  specified  value  while 
y  is  steoped  by  a  constant  value. 

v  R  Z  -  vector  relative  auto-increment  z  ;  each  draw 

instruction  causes  the  x  and  y  coordinate  values 
to  be  incremented  by  the  specified  value  while 
z  is  steooed  by  a  constant  value. 
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TABLE  A-I 
(cont  i  nued) 


INC2-  two-dimensional  incremental  vector;  a 

relative  vector  that  optimizes  storage  re- 
quirements.  The  coordinate  increment  values 
are  limited  to  values  aoprox i mat e 1 y  3%  of  the 
user's  coordinate  range. 

INCX-  two-dimensional  incremental  auto-increment  x; 
is  a  relative  vector  that  optimizes  storage 
reau i remen t s  .  The  y  coordinate  value  is 
incremented  by  a  small  value  while 
x  is  stepped  by  a  constant  value. 

INCY-  two-dimensional  incremental  aut o- i nc rement  y) 
is  a  relative  vector  that  optimizes  storage 
regu i remen t s .  The  x  coordinate  value  is 
incremented  by  a  small  value  while 
y  is  stepped  by  a  constant  value. 

I N  C  3  -  three-dimensional  incremental  vector?  a 

relative  vector  that  optimizes  storage  re- 
quirements. The  x,  y,     z  coordinate  increment  values 
are  limited  to  values  that  are    approximately  3% 
of  the  user's  coordinate  range. 
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A  more  detailed  account  of  each  vector  tvoe  and  the 
parameters  required  by  setvector  are  listed  in  Apoendix  B. 
Figure  A-4  illustrates  the  five  different  vector  modes  that 
are    available. 


VECTOR  MODE 


PARAMETER  VALUE 
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Vector  Modes 
FIGURE  A-4 


b .   M0ve 

The  draw  instruction  move  is  used  to  reposition 

the   beam  on  the  display  screen.   It  will  produce  no  visible 

line  or  oattern.  The  format  of  the  instruction  is: 

moveCx  [ , y 1   r>zJ); 

The  coordinate  values  x,  y,  z  will   Pe   either   absolute  or 

relative    values.     The    vector   tyoe   selected   in  the 

preceeding  setvector   instruction   will   determine   how  the 
value  of  these  parameters  will  be  interpreted. 
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A  move  instruction  under  an  absolute  vector  type  w i 1 1 
reposition  the  beam  at  the  absolute  coordinate  given  in  the 
move  instruction  parameter  list.  Absolute  parameter  values 
which  exceed  the  limits  of  the  defined  coordinate  system 
will  be  assigned  a  value  of  the  nearest  coordinate  within 
the  defined  system. 

A  move  instruction  under  a  relative  vector  type  will 
reoosition  the  beam  at  a  location  determined  by  adoing  the 
parameter  values  to  the  oresent  beam  location.  Relative 
parameter  values  which  exceed  one-half  the  coordinate  range 
will  be  set  to  zero . 

The  bracketed  values  indicate  oarameters  that  may  be 
ootional.  If  the  user  coordinate  system  is  not  three- 
dimensional*  the  z  parameter  can  be  omitted/  and  will  be 
ignored  if  it  should  be  included. 

c  .   Line 

The  line  instruction  draws  a  visible  line  or 
vector  on  the  display  screen.  The  line  is  drawn  from  the 
present  oeam  locaton  to  the  soec i f i ed  end  point.  The  format 
of  the  instruction  is: 

1  i  n  e  (  x  [ ,  y  1   [ ,  z  ]  )  ', 

The  coordinate  values  x,  y,  z  will  be  either  absolute  or 
relative  values.  The  vector  type  selected  in  the  previous 
setvector  determines  how  the  value  of  these  parameters  will 
be  interpreted. 

A  line  instruction  under  an  absolute   vector   tyoe   will 
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draw  a  line  from  the  oresent  beam  position  to  the  absolute 
coordinate  specified  in  the  line  instruction  parameter  list. 
Absolute  parameter  values  which  exceed  the  limits  of  the 
defined  coordinate  system  will  be  assigned  a  value  of  the 
nearest  coordinate  within  the  defined  system. 

A  line  instruction  under  a  relative  vector  tvoe  will 
draw  a  line  from  the  oresent  beam  Dosition  to  a  point 
determined  by  addina  the  parameter  values  to  the  present 
beam  location.  Relative  parameter  values  which  exceed  one- 
half  the  coordinate  range  will  be  set  to  zero. 

If  the  user  has  defined  a  two-dimensional  coordinate 
system,  the  z  oarameter  can  be  omitted,  and  will  be  ignored 
if  it  should  be  induced. 

d.   Circle 

The  circle  instruction  will  draw  a  circle 
beginning  at  the  present  beam  location  about  the  center 
point  specified  bv  the  user.  The  difference  between  the 
oresent  beam  location  and  the  center  point  determines  the 
radius  of  the  circle.  The  instruction  is  used  by  the 
following  f o  r^a t : 

circle(dir,centx  twenty]   [ ,  c  e  n  t  z  ]  )  ; 

The  parameter  dir  indicates  in  which  direction  the 
circle  is  to  be  drawn,  clockwise  or  counterclockwise.  The 
number  of  oarameters  reauired  and  their  values  are 
determined  by  the  vector  type  selected  in  the  previous 
setvector  instruction. 
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Circle  commands  issued  under  absolute  vector  tyDes  will 
cause  the  circle  to  be  drawn  about  a  center  point  as 
soecified  in  the  parameter  list.  Absolute  parameters  which 
exceed  the  limits  of  the  defined  coordinate  system  will 
assume  a  value  of  the  nearest  coordinate  within  the  defined 
system  . 

Circle  commands  issued  under  relative  vector  tyDes  will 
cause  the  circle  to  be  drawn  about  a  center  point  determined 
bv  aading  the  oarameter  values  to  the  present  beam  location. 
Relative  oarameter  values  which  exceed  one-half  the 
coordinate  range  will  be  set  to  zero. 

If  the  user  coorainate  system  is  two-dimensional/  the  z 
parameter  can  oe  omitted/  and  will  be  iqnored  if  included.  A 
circle  cannot  be  drawn  by  any  of  the  four  incremental 
vec  t ors . 

e .   Arc 

The  arc  instruction  will  draw  an  arc  from  the 
oresent  beam  location/  about  the  specified  center  point/  to 
the  oesired  end  ooint.  The  distance  between  the  start ina 
point  and  the  center  point  determines  the  radius  of  the  arc 
being  drawn.   The  instruction  format  is  : 

arc (d i r , cent x  [/centvJ   C / cen t z] / endx  [,endv)   t/endzJ)? 

The  parameter  dir/  gives  the  direction  the  arc  is  to  be 
drawn/  clockwise  or  counterclockwise.  The  arc's  actual 
center  and  end  points  are  determined  by  the  vector  tyoe 
selected   in   the   previous   call   to   setvector/  and  by  the 
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supplied  oarameter  values. 

Arc  commands  issued  under  absolute  vector  tyDes  will 
result  in  the  center  and  end  points  being  absolute 
coordinates  as  given  in  the  command  oarameter  list. 
Absolute  oarameters  which  exceed  the  limits  of  the  defined 
coordinate  system  will  assume  a  value  of  the  nearest 
coordinate  within  the  defined  system. 

Arc  commands  issued  under  relative  vector  tvoes  will 
result  in  the  end  point  of  the  arc  being  determined  by 
adding  the  endx»  endy*  and  endz  values  to  the  present  beam 
location.  The  center  ooint  is  then  obtained  by  adding  the 
centx,  centy*  and  centz  values  to  the  end  ooint.  Relative 
oarameters  which  exceed  one-half  the  coordinate  range  will 
oe  set  to  zero . 

If  the  user  coordinate  system  has  been  defined  as  two- 
dimensional  ,  the  z  oarameters  can  be  omitted*  and  will  be 
ignored  if  included.  An  arc  cannot  be  drawn  by  any  of  the 
four  incremental  vectors. 

If  the  distance  from  the  starting  ooint  of  the  arc  to 
the  center  point*  and  the  distance  from  the  end  point  to  the 
center  ooint  are  not  equal*  the  resulting  arc  will  contain  a 
straight  line.  The  straight  line  results  from  the  arc 
generator  trying  to  comoensate  for  the  two  different 
distances  to  the  center  ooint.  One  distance  will  be  used  to 
determine  the  radius  of  the  arc**  the  arc  will  then  be  drawn 
using  this  radius.  The  arc  will  stop  at  the  systems  new 
defined  end  point  and  a  straight  line  will  be  drawn  to  the 
end  point  that  had  been  soecified  by  the  user.  The  resulting 
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arc  aooears  in  the  following  form: 


2.   Character  Element 

A  character  element  represents  ASCII  character  data  that 
is  to  be  i ncoroo ra t ed  into  the  picture  structure.  A  user  can 
soecify  a  character  element  containing  ASCII/  soecial  Vector 
General  characters  and  formatting  symbols  to  be  displayed  on 
the  Vector  General  display  screen.  A  user  can  select  from 
four  character  sizes  and  has  the  option  of  selecting  a 
slanted  character  set.  The  text  can  be  displayed 
horizontally  or  vertically  on  the  screen.  The  vertical 
position  causes  the  characters  to  appear  as  if  they  were  on 
a  page  that  had  been  rotated  ninety  degrees  counter 
clockwise.  The  user  can  select  the  position  on  the  screen 
where  the  string  is  to  begin,  or  can  output  it  relative  to 
the  present  beam  position. 

Each  character  element  is  given  a  uniaue  name  by  the 
user.  This  name  will  allow  the  user  to  easily  reference 
each  character  element.  There  ars  two  routines  which  can 
produce  character  element  strings. 

a  .   Cha  re  1 e 

The  charele  instruction   produces   a  character 

element   string   of   a   given  length.   The  charele  character 

element  generally  reauires  less  disolay  list  space  than   the 
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printv  character  element  and  is  designed  for  elements  which 
do  not  change.  The  character  element  is  represented  by  the 
following  format: 

charel  e  (  "  e  1  ement-name",  s  t  r  i  n  g  ,  s  i  z  e  *  w  d  i  r ,  s  1  ant  ,  x  ,y)  ', 

The  oarameter  string  can  be  either  a  quoted  string 
within  the  oarameter  list  or  a  pointer  to  a  character  string 
or  array.  The  character  strinq  will  begin  at  the  ooint(x,y) 
or  can  be  output  relative  to  the  oresent  beam  location  by 
replacing  the  x  and  y  parameter  with  the  constant  VGREL. 
For  examole/  the  following  character  element*  when  linked  to 
art  object*  would  be  outDut  relative  to  the  present  beam 
oos  i  t  i  on  : 

charel eC "el ement-name" / "Now  is  the  t i me" , SZ4,H0R, SLNT, VGREL) ; 

A  summary  of  the  character  element  parameters  is 
oresented  in  Table  A  - 1 1  .  The  character  set  available  on  the 
Vector  General  is  illustrated  in  Figure  A-5.  All  of  the 
Vector  General  characters  can  be  represented  within  a 
Character  string.  The  soecial  formatting  symbols  and 
soecial  Vector  General  characters  are    listed  in  Appendix  B. 
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TABLE  A-II 


SUMMARY  OF  CHARACTER  ELEMENT  PARAMETERS 


size:  specify  character  size 


SZ   /  00 

SZ1  /  0100 

SZ2  /  0120 

SZ3  /  0140 

SZ4  /  OloO 


-  use  previously  defined  character  size 

-  set  size  to  100  columns  by  60  lines 

-  set  size  to   81  columns  by  41  lines 

-  set  size  to   60  columns  by  30  lines 

-  set  size  to   32  columns  by  16  lines 


id  i  r :  write  di  rect i  on 


HOR  /  00 
VER  /  0200 


write  characters  horizontally 
write  characters  vertically 


slant:  specifies  regular  or  slanted  characters 

SLNT  /  00    -  slanted  characters 
NSLNT/  01    -  regular  characters 


83 


0-    1 

8     • 

A    { 

* 

t     I 

I 

\\     i — i 

«-*-v 

U     X 

r 

V    S 



I      <* 

— 

•  ^    i — j 

^-t-' 

X.        -J 

u 

..    x 

N 

t 

fr 

C^    X 

:r> 

c:      V 

< 

00    X 

X 

o     <*— 

-0 

in  rz 

2 

X      < 

"\ 

vO    > 

> 

<rc    n-> 

0 

in  3 

3 

<     - 

0 

<r  t~ 

-<-> 

U  <D 

V- 

m  co 

CO 

□  1*1 

lo 

c\i  en 

L. 

>    -3- 

a- 

—  o 

CT 

«-    c 

j} 

S    Cl. 

CL 

o    fc= 

c= 

X   o 

0 

r    a 

3 

•  z: 

c 

Ai    JE^ 

^ 

i     n 

e 

o«    til 

2. 

-  —i 

— 

Mi     < 

/< 

+   ^ 

JXL 

•*•      r 

\ 

*   -o 

•*-** 

o       o 

^ 

•""^    1 1 

•  r"~ 

n    -9- 

_x 

^  X 

^ 

0       f- 

H 

-    o 

CD 

>      o 

S 

u3    LL 

<+- 

^       & 

-e. 

^    LLI 

0) 

>   m 

<j> 

&   a 

~d 

cj^       < 

uO 

n   u 

u 

0  •; 

> 

:       CQ 

X) 

cn. 

-o       < 

<d 

-*  > 

« 

(3 

y 

a    % 

3 

Character    Set 

FIGURE    A-5 

8a 


b .   Pr i  nt v 

The  Drintv  instruction  provides  for  a  formatted 
output  character  element  string  of  variable  length.  Maximum 
character  length  for  a  Drintv  character  element  string  is 
100  characters.  The  printv  character  element  is  designed 
for  output  character  strings  which  change  frequently.  The 
orintv  character  element  is  represented  by  the  following 
format  : 


Drintv("elename",si  z  e  #  w  d  i  r»slant»xpos»ypos/"format" 

C  ,  a  r  a  1  ,  a  r  g  2  , ,  a  r  a  1  0  ]  ); 


The  first  six  oarameters  are  identical  in  use  to  the 
charele  format  in  initializing  and  oositioning  the  character 
string.  The  orintv  character  string  cannot;  however*  be 
Dositioned  relatively  but  must  be  suDolied  with  both  X  and  Y 
absolute  coordinates.  The  format  parameter  and  ten  ootional 
arg  oarameters  are  used  as  in  a  standard  printf  statement  in 
formatting  outDut. 

An  examole  of  the  use  of  the  orintv  character  element 
wou Id  oe  as  foil ows : 


orintv(HRESUlT",SZ4,H0R,SLNT,5.0,0.0, "resul  t  =  %d", 

resu It); 


and  could  be  changed  later  in  the  program  to: 


or i ntv( "RESULT" ,  S Z 3 , HOR , NSLNT , - 1 0.0, 15.0, "score  =  %d", 

score) ; 
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C.   LINKING  ELEMENTS  TO  OBJECTS 

Draw  and  character  elements  represent  the  smallest 
picture  segment  that  can  be  i ndeoenden t 1 y  referenced  by  the 
user.  In  order  to  display  an  element  it  must  be  associated 
with  at  least  one  object.  An  object  reoresents  the  smallest 
entity  that  can  be  displayed  i ndeoenden t  1  y  on  the  Vector 
Gene  ra 1  sc  reen  . 

1.   Object  Routine 

Each  object  is  given  a  unique  name  so  it  can  be 
easily  referenced  by  the  user.  Elements  can  be  linked  to  an 
object  at  one  time  or  by  several  different  calls  to  the 
routine  called  object.  An  object  can  consist  of  one  or  more 
elements.  A  soecific  element  can  be  linked  to  several 
different  objects?  or  may  be  linked  to  one  object  several 
times.  This  object-el  ement  association  or  linking  is 
established  by  the  routine  object.  This  routine  has  the 
following  f o  rma t  : 

object  (num>  "object-name",  "el  ement-name",  .  .  .  ,  "element-name")  »* 

The  oarameter  num  indicates  the  number  of  elements  that 
are  to  be  linked  to  the  named  object  by  this  call.  The 
elements  are  referenced  by  the  names  specified  by  the  user 
in  the  preceding  a  r  a  w  e  1  e  ,  c  h  a  r  e  1  e  ,  and  orintv  routines. 
Since  each  object  is  associated  with  a  uniaue  name,  a  second 
call  to  object,  with  a  duplicated  object  name,  will  cause 
the  elements  to  be  added  to  the  object  first  associated  with 
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that  name . 

rthen  an  element  is  linked  to  a  specific  object  several 
times*  the  user  can  no  longer  reference  a  specific 
occurrence  of  this  element  within  the  object*  for  example: 

object (3,  "Tree". "branch", "branch", "branch") ; 

In  this  case  the  element  branch  has  been  linked  to  the 
object  tree  three  times.  When  displayed,  element  branch 
will  aooear  three  times.  Now,  however,  the  user  cannot 
uniauely  reference  a  specific  occurrence  of  the  element 
branch.  If  the  element  called  branch  was  selected  to  be 
erased,  the  first  occurrence  of  branch  would  be  erased  from 
the  screen.  In  many  instances  it  may  be  desirable  to 
uniauely  reference  each  occurrence  of  an  element  within  a 
specific  ooject.  This  can  be  accomplished  by  associating 
several  uniaue  names  with  an  element.  The  routine  copyele 
oroviaes  tnis  capability. 

2. .   Coove  1  e  Rout  i  ne 

This  routine  allows  a  user  to  assign  several  uniaue 
names  to  a  soecific  element  structure.  In  this  way,  an 
element  structure  can  be  associated  with  an  object  several 
times  and  each  occurrence  can  be  uniauely  referenced.  Tne 
routine  is  reoresented  by  the  following  format: 

cooyel e(num,  "el ement-name", "cooyl-name", "copy2-name" , . . . ) \ 
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The  parameter  num  indicates  the  number  of  additional  names  a 
user  wishes  to  associate  with  the  named  element  structure. 
The  "element-name''  refers  to  a  previously  defined  draw 
element  or  character  element  block.  Each  of  the  "copy- 
names"  must  be  unique. 

Now  reconsider  the  previous  example.  If  the  element 
branch  is  associatec  with  two  other  unique  names  and  these 
three  names  are  used  in  the  ob j ec t -e 1 ement  linking,  each 
occurrence  of  the  structure  can  now  be  uniquely  referenced 
by  the  user.  The  following  two  statements  will  accomplish 
this  task. 

coovel e (2, "branch", "branch l","branchaM)  ; 
object (3, "tree", "branch", "branch l"f"branch2")  ; 
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V.   USER  SUPPORT  ROUTINES 


After  the  user  has  incorporated  all  data  that  is  to  be 
displayed  into  the  desired  picture  structure,  it  can  now  be 
manioulated  and  transformed.  The  following  user  routines 
orovide  the  means  to  manipulate  the  picture,  objects  and 
elements  that  have  been  created  by  the  user. 

A  descriotion  of  each  user  routine,  calling  format  and 
error  diagnostics  are  included  in  AoDendix  B. 

A.   PICTURE  REPRESENTATION 

1  .   81  i  n< 

The  display  blin*  mode  can  be  set  for  the  entire 
picture,  single  object  or  for  any  number  of  elements 
associated  with  a  specific  object.  Modifying  the  blink  mode 
of  an  object  affects  all  the  elements  associated  with  that 
object.  The  routine  blink  will  turn  the  blink  mode  on  or 
off  for  the  soecified  oicture  segment. 

2 .   Erase 

The  entire  oicture,  a  single  object  or  any  number  of 

elements   associated   with   a   specific  object  can  be  erased 

from  the  display  screen.    The   oicture   segments  that   are 

erased    from    the   screen   can   be   redisolayed  by   again 
establishing  the  desired  object-element  association.  This  is 

accomolished   bv   calling   the   routine  object,  as  described 
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earlier.    Erasing   an   object   will   affect   all    elements 
associated  with  the  named  object. 

3.  Remove 

The  routine  remove  provides  a  user  with  the  ability 
to  release  the  memory  locations  associated  with  a  soecific 
element  structure.  The  user  can  remove  the  picture  and 
release  all  the  memory  locations  that  have  been  used  to 
aescribe  all  the  existing  elements.  Additionally  the  picture 
will  be  erased  from  the  screen.  Each  element  that  is  removed 
from  memory  can  no  longer  be  referenced  or  linked  to 
objects.  An  indiviaual  element  can  also  be  removed  from 
memory.  This  will  cause  every  occurrence  of  the  element  to 
be  erased  from  the  screen  and  the  memory  locations 
associated  with  the  element's  description  will  be  released. 
The  user  can  soecify  an  element  for  removal  by  either  its 
original  name  or  by  any  of  the  copy  names  associated  with 
it.  Remove  results  in  the  elimination  of  all  occurrences  and 
all  copies  of  an  element  from  the  display  screen.  An 
element  that  has  oeen  removed  can  be  redisplayed  only  by 
reconstructing  the  element  block  and  by  again  establish  ina 
the  desired  ob j ec t -e 1 emen t  association. 

4 .  Display 

The  display  of  the  entire  picture/  an  object/  or 
individual  elements  may  be  activated  or  deactivated  with 
this  routine.  Object-element  associations  are  not  affected 
with  this  routine  as  they  are  with  erase  and  remove. 
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5.  Refresh 

The  default  diSDlay  refresh  rate  is  40  Hz  and  may  be 

altered   from   15  to  120  Hz  with  this  routine.   High  refresh 

rates  ensure  no  flicker  but  may  not   allow   enough   time   to 

execute  all  desired  draw  commands  before  refresh  begins 
again.  Low  refresh  rates  allow  more  draw  commands  but  with 
an  increase  in  flicker. 

6.  Offset 

Picture  coorainate  axis  Dositioning  is  normally 
centered  on  the  display  screen  but  may  be  altered  with  this 
routine.  Alterina  of  the  Dicture  coordinate  axis  will 
affect  all  objects  in  the  cicture. 

7.  Pscale 

Modification    of    the  picture    scale    may    be 

accomDlished   by   calling   this  routine.   All  objects  within 

the  diSDlay  are  affected  by  a  modification  with  this 
rout  i  ne . 

8.  Intensi  ty  Of  f set 

The  routine  intoffset  allows  the  user  to  vary  the 
intensity  level  of  a  three-dimensional  object*  or  impose  a 
screen  cut-off  plane  for  the  named  object. 

9  .   Int ens  i  t  y  Sea  1 e 

The  routine  intscale  allows  a  user  to  vary  the 
intensity  of  a  three-dimensional  object.  This  provides  the 
deDth-cueing  or  shading  for  a  three-dimensional  object. 
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B.   PICTURE  MANIPULATION 

1 .   Rotate 

This  routine  allows  a  user  to  rotate  an  object  about 
the  x/  y,  and  z  axis.  The  rotation  of  an  object  affects  all 
elements  associated  with  the  named  object.  Arcs?  circles 
and  characters  are  always  drawn  in  a  plane  parallel  to  the 
screen*  and  are  rotatable  in  a  three-dimensional  coordinate 
system  about  the  z-axis. 

2. .   Scale 

The  routine  scale  allows  a  user  to  independently 
scale  any  object  of  the  picture.  All  elements  associated 
with  the  object  will  be  scaled  by  the  specified  scale 
factor. 

3.  Translate 

The  routine  trans  allows  the  user  to  move  an  object 
anywhere  in  the  display  soace.  Tne  object  and  all  its 
associated  elements  can  be  moved  in  the  x,  y*  and  z  olanes. 
Continually  translating  an  object  by  very  small  increments 
will  cause  it  to  aooear  as  if  it  is  moving  across  the 
di  so  1  ay  sc  reen  . 

4 .  PI  ace 

The  place  routine  allows  the  user  to  place  or 
position  an  object  anywhere  in  the  display  space. 
Specification  of  an  absolute  coordinate  value  will  cause  the 
coordinate  axes  of  the  object  to  be  centered  on  the 
soec  i  f  i  ed  value. 
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C.   EXTERNAL  DEVICES 

1 .  Cursor 

This  routine  allows  the  user  the  option  of 
activating  or  deactivating  the  display  of  the  trackball/ 
joystick/  or  lightoen  cursor. 

2.  Posi  t 

This  routine  will  return  to  the  user  a  floating 
point  value  of  the  cosition  of  the  trackball/  joystick/  or 
lightoen  cursor.  The  cursor  need  not  be  displayed  for  this 
rout  i  ne  to  work. 

3.  Keyboard 

a .  Cget 

The  routine  cget  allows  a  user  to  receive  and 
output  characters  from  the  Vector  General  keyboard  onto  the 
display  screen.  The  ASCII  character  data  is  also  placed  in 
a  user  soecified  character  array  for  processing  by  the 
user's  program.  Up  tc  121  characters  can  be  entered.  Data 
entry  is  terminated  by  a  carriage  return.  The  termination 
of  the  data  entry  also  erases  the  outDut  characters  from  the 
display  screen. 

b.  Fget 

The  fget  routine  returns  to  the  user  a  floating 
point  number  entered  from  the  Vector  General  keyboard.  This 
routine  uses  both  the  cget  and  getf  routines. 
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c.   Iget 

The  iget  routine  returns  to  the  user  an  integer 
entered  from  the  Vector  General  keyboard.  This  routine  uses 
both  the  cget  and  geti  routines. 

4  .   Li  ghtoen 

a .  Lgh  t  pen 

The  HghtDen  se  1  ec  t  ab  i  1  i  t  y  of  the  picture,  a 
single  object,  or  any  number  of  elements  associated  with  a 
soecific  object  can  be  turned  on  or  off  bv  this  routine. 
This  determines  what  picture  segments  will  be  affected  by 
lightpen  interactions. 

b.  Penh  i  t 

After  an  element's  lightoen  se 1 ec t ab i 1 i t y  has 
\oeen  activated  with  the  IghtDen  routine/  determination  of 
whether  or  not  an  element  has  registered  a  liahtpen  hit  is 
accomolished  with  this  routine.  A  one  is  returned  if  a 
lightoen  hit  has  occurred?  otherwise  a  zero  is  returned. 

For  an  element  to  register  a  lightpen  hit  it  is 
necessary  not  only  for  the  element's  lightoen  se 1 ec t ab i 1 i t y 
to  have  oeen  activated,  but  also  the  lightpen  must  be 
oointing  at  the  element  and  the  lightoen  sense  switch  must 
oe  activated.  The  lightoen  sense  switch  is  activated  bv 
bridging  the  small  rudber  gao  on  the  forward  part  of  the 
light  oen . 
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c .  CI rhi  t 

This  routine  is  used  to  clear  the  elements  of 
lightDen  hits.  Element  lightDen  se 1 ec t ab i 1 i t y  is  unaffected 
by  this  rout  i  ne  . 

5.   Function  Switches 

a.   Fsman 

This  routine  returns  to  the  user  an  indication 
of  whether  or  not  a  specified  function  switch  is  depressed. 
A  one  is  returned  to  the  user  if  deoressed/  otherwise  a  zero 
if  returned. 

b  .   Fst og 

This  routine  makes  the  function  switches   aooear 

as   toggle   switches.    Odd   (  1  st r 3rd*  .  .  .  )  selections   of  a 

switch  light  the  lamp  an<3       return   a   value  of   one.    Even 

(  2nd / 4t h , .  .  .  )   selections   turn   the   lamp  off  and  return  a 
value  of  zero . 

C .   LamD 

The  lamo  routine  will  light  or  extinguish  the 
soecified  function  switch  lamo. 

d .  Man  i  n t 

Each  deoression  of  the  manual  interruDt  function 
switch  increments  the  manual  interrupt  count  by  one.  The 
■nanint  routine  either  returns  to  the  user  the  present  manual 
interrupt  count  or  sets  that  count  to  zero. 
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6  .   Coot  ro 1  Dials 

The  dial  routine  returns  a  floating  point  number  from 
-1.0  to  1.0  to  the  user  to  indicate  the  relative  position  of 
the  SDecified  control  dial. 
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VI.   RUNNING  A  VECTOR  GENERAL  PROGRAM 


A.   PROGRAM  FORMAT  4ND  COMPILATION 

In  order  to  prooerly  utilize  the  Vector  General  display 
system,  routines  to  initialize  and  terminate  the  system  must 
be  called.  These  routines  initialize  the  Vector  General, 
start  the  actual  visual  disolay  and  prooerly  terminate  the 
display  at  the  end  of  a  user's  orogram.  Each  user  program 
must  include  a  call  tc  these  three  routines: 

S  y  S  i  n  i  t  (  )  ; 
vgo  i  c  t  ure ( ) ; 
v  g  t  e  r  m  (  )  ; 

The  first  routine,  sysinit,  must  be  called  by   the   user 

before   any   other   user   interface   routine   is  called.   To 

disolay  the  picture  that  a  user  has  described  on  the   Vector 

General   screen,   the  routine  vgpicture  must  be  called.  This 

routine  is  called  only  once,  and  notning  will  aopear  on   the 

screen   until    it   has   been   called.    Finally,  to  orooerly 

terminate,  the  system  reauires  a  call  to  the  routine   vgterm 

at  the  end  of  the  user  orogram. 

1  .   C  P  rograms 

To  orooerly  initialize  various  data  structures  in 
the  interface  routines  and  utilize  the  Vector  General 
program  constants  usee  in  this  manual  the  first  line  in  the 
user's  program  should  be: 
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^include  M /usr/graph/ vgdat a" 

Once  a  C  program  has  been  written  it  must  be  compiled 
with  the  user  interface  graphics  subroutine  library.  To 
accomolish  this  the  following  command  must  be  issued: 

vgc  f  i 1 ename  .c 

The  result  of  a  successful  compilation  is  an  executable 
a .out  file. 

2  .   Basic  P  roarams 
The  first  subroutine   call   made   by   the   BASIC   program 
should  be : 

call  vadat  a ( ) 

This  causes  the  loading  of  the  initialized  display  list. 
Care  must  be  made  in  previously  declaring  the  "vgdata"  call 
in  an  "extern"  statement  before  this  call.  This  call  would 
be  in  lieu  of  the  "include"  statement  used  by  the  C 
programs . 

The  program  constant  names  used  in  the  C  Vector  General 
programs  do  not  apply  in  BASIC  Vector  General  programs. 
Conversion  values  must  be  utilized  instead  of  the  string 
constant  names  when  programming  in  8ASIC.  The  following 
taole  lists  the  constant  names  and  the  equivalent  values  in 
aecimal  number  representation  to  be  used: 


DEFINE  VECTOR  TYPES 
VR   =  a096  VAY  =  4102 

VRX  =  4097  VAZ  =  a  1 03 

VRY  =  4098  INC2  =  4104 
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VRZ  =  4099 
VA  =  U100 
VAX  =  a  1 0  1 

LN   =  0 
OSH  =  16 
OOT  =  32 

AIR  =  0 
XR  =  1 
YR  =  2 
ZR   =  3 

C   =  a 
CC  =  8 


NMG  =  0.0 
MG   =128.0 

SLNT  =  0 
NSLNT  =  1 

HOR  =  0 
VER  =  128 

SZ   =  0 
SZ1  =  64 
SZ2  =  80 

ON   =  1 
OFF  =  0 

PIC  =  0 
OBJ   =  -1 

LPEN  =  0 

TRK   =  1 


INCX  =  4105 

INCY  =  4106 

INC3  =  4107 
DEFINE  VECTOR  MODES 

PT   =  48 

DD   =  80 

ODD  =  96 
DEFINE  COORDINATE  FIELD  VALUES 

X  =  0 

Y  =  1 

Z  =  2 

DEFINE  OF  AND  CF  FIELDS  FOR  ARC  COMMANDS 


DEFINE  FIELDS  FOR  INCREMENTAL  VECTORS 
INCREMENT  SCALE 


DEFINE  CONSTANTS  FOR  CHARACTER  GENERATION 
VGREL  =  -.00001 

CHARACTER  WRITE  DIRECTION 


CHARACTER  SIZE 

SZ3  =  96 
SZ4  =  1 12 

DEFINE  ACTION  PARAMETER 

CLEAR  =  0 

COUNT  =  1 
DEFINE  CASE  STATEMENT  VALUES  FOR  OBJ-ELE-PIC 

ELE  =  1 

DEFINE  DEVICE  SWITCH  NUMBERS 
JOY  =  2 


Once  a  BASIC  orocram  has  been  written,  it  must  be 
comDi led  with  the  various  user  subroutine  libraries.  To 
accomplish  the  task,  the  followinq  system  resident  command 
mus t  be  i  ssued : 

vgb  f  i 1 ename .b 

The  result  of  a  successful  comoilation  is  an  executable 
"a. out"  file. 
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B.   SAMPLE  PROGRAMS 

1  .   C  P  roqrams 

The  following  is  an  example  of  a  C-language  Vector 
General  graphics  orogram.  The  actual  oicture  produced  by 
this  Drogram  is  illustrated  in  Figure  A-6. 

^include  H /us r /graph/ vgdat a " 

ma  i  n ( ) 
{ 
i  n  t  i  ; 

svsinitCO);  //initialize  the  Vector  General 

//define  coordinate  system 
coordsys(2,-1.0, 1.0,-1.0, 1.0); 

draweleCbox")  ; 

set  vector (VA,LN) ; 

move(-l .0,-1.0) 

1 ine(  1.0,-1.0) 

1 ine(  1.0,  1.0) 

1 ine(-l .0,  1.0) 

1 ine(-l .0,-1  .0) 
enaeleO; 

charele("name","sl  BOX " , SZU , HOR , NSLNT , VGREL ) ; 

drawel e  C " z  i gzag" ) ; 

setvector  ( VA,|_N) ; 

move(-0.5, -0.5)  ; 
setvector(INCX,LN, .0  3,NMG) ; 
f  o  r  (  i  =  0  ,*  i<  7  ;  i  +  +■  ) 
1  ineC  .03, -.03)  ,* 
e  n  a  e  1  e  (  )  ,* 

//establish  object-element  relationshio 
object  (3,,,biqbox^,,box^,,name","zigzaq,,); 
ob j  ect ( 3, "smallpox", "box"," name" ,  "z  i gzag"); 

scale("bigoox",0.5); 
trans("bigbox",-0.5,-0.5); 
scale("smal  1  box" , 0.25) ; 
trans("smal lbox",0.5,0.5); 

vgpictureC),"     //display  picture 
sleep(30);   //display  picture  for  30  sec 
vqterm();    //terminate  Vector  General  process 
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2 .   Basic  Program 

The  following  is  an  example  of  a  BASIC  Vector  General 
graphics  program.  The  actual  picture  produced  by  this 
program  is  illustrated  in  Figure  A-6. 


rem     external  subroutine  declarations 

extern  vgdat  a  (  ) 

extern  svsinit (integer) 

extern  coordsys(integer,double,double,double,double) 

extern  dr awe  1 e ( &c har ) 

extern  setvector(integer, integer,double,double) 

extern  move ( doub 1 e , doub 1 e ) 

extern  1 i ne ( doub 1 e , doub 1 e ) 

extern  enoe 1 e (  ) 

extern  charele(&char,&char, integer, integer, integer, double) 

extern  object (inteaer,&char,&char,&char,&char) 

extern  sc a  1 e ( &c ftar , doub 1 e ) 

extern  trans(&char,doub1e, double) 

extern  vgpictureO 

extern  sleeo( integer) 

extern  vgt  erm (  ) 

rem     initialize  display  list 
call  vgdat  a  ( ) 

rem     initialize  the  Vector  General 
call  sysinit(O) 

rem     define  coordinate  system 
call  coordsys(2, -1.0, 1.0,-1.0,1.0) 

call  draweleCbox") 


cal 
ca  1 
cal 
ca  1 
ca  1 
ca  1 
ca  1 


setvector (U100, 0,0,0) 
move(-l .0,-1.0) 
1  ine( 1  .0,-1  .0) 
lined. 0,1.0) 

1 ine(-l .0,  1  .0) 
1  i ne(-l .0,-1  .0) 
ende 1 e ( ) 


call  charele("name","»I  BOX" , 1 12, 0 , 1 , -. 0000  1  ) 

call  arawel e ( "zigzag" ) 

call  setvector (4100, 0, 0,0) 

cal 1  move(-0.2, 0.0) 
call  setvector (4105, 0,  .03,0) 
for  i  =  0  to  6 

call  1 ine( .03, -.03) 
nex  t  i 
call  ende 1 e ( ) 


ca 


rem     establish  ob j ec t -e 1 emen t  relationship 
object (3, "bigbox"," box", "name"  , "zigzag") 
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call  object  (3,Msmal  lbox",,,boxl,,,,naaie\,lzig2agN) 

cal  1  seal  eCbi  qbox"  ,0.5) 

call  t  rans(Mbiqbox",-0.5,-0.5) 

call  scaleCsmal  lbox",0.25) 

call  t rans ("small  box" , 0.5/ 0.5) 

rem     diSDlay  oicture 
call  vgpi  ctureO 

rem     display  oicture  for  30  sec 
call  si eeo ( 30 ) 

rem     terminate  Vector  General  process 
call  vqt  e  rm ( ) 
end 
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Picture  DiSDlayed  by  Sample  Proqram 
FIGURE  A-6 


103 


C.   ERROR  DIAGNOSTICS 

A  user  can  control  the  printing  of  error  messages 
through  the  use  of  the  errormsg  routine.  The  general  format 
of  an  error  message  will  be  as  follows: 

E-nn    TTTT:   "eeee"  in  routine  rrrri) 
where : 

nn  =  error  number 
TTTT  =  error  t  yoe 
eeee  =  error 
rrrr  =  routine  in  error 
For  ex  amp  1 e : 

1.  E-l   BLOCK:   in  routine  lineO 

M  e  s  s  a  g  e  indicates  a  block  error  in  routine 
lineO.   Probable  cause  is  a  lineO  command  issued 
outside  a  dr'aweleO  block.   The  I  ine()  command  will 
be  disregarded  and  control  returned  to  the  user's 
p  rogr am  . 

2.  E-5   NO  OBJ:  "Tree"  in  routine  eraseO 

Message  indicates  that  the  object  'Tree'  has 
been  used  in  the  eraseO  routine  and  no  such  object 
currently  exists.   Routine  will  be  disregarded  and 
control  returned  to  the  user's  program. 

3.  E-15   X:   "150.000000"  in  routine  printvC) 

Message  indicates  an  improoer  X  coordinate 
value  in  the  orintvO  routine.   The  erroneous  X 
coordinate  value  of  150  will  be  reduced  to  a  value 
within  the  defined  coordinate  system  (ie:  100  for 
default  coordinate  system)  and  the  routine  will 
continue  execution. 

a.   E-25   Nliw  DIAL:   "3b"  in  routine  dialO 

v  e  s  s  a  g  e  indicates  an  improoer  dial  number 
of  36  used  in  the  aia' ()  routine.  Routine  will 
return  a  value  of  0.0  to  the  user. 

A  brief  idea  of  the  cause  of  the   error   may   be   gained 
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from  the  error  tyoe  specification  in  the  error  message. 
Hooefully  with  a  soec i f i cat i on  of  the  error,  the  error  type 
ana  routine  where  the  error  occured,  the  user  will  be  able 
to  quickly  trace  and  correct  the  problem.  Should  a  more 
detailed  explanation  be  desired,  a  fuller  description  of  the 
specified  error  may  be  obtained  with  the  help  of  the  error 
number  and  error  diagnostic  table,  or  by  reviewing  the 
diagnostic  section  under  the  routine  in  question. 

The  software  suooort  o  a  c  k  a  g  e  is  designed  so  that  most 
errors  will  not  terminate  a  user's  program,  and  in  fact  most 
errors  will  usually  result  in  the  termination  of  the 
specified  routine  and  return  control  to  the  user's  program. 
Every  effort  will  be  made  to  execute  the  support  routines 
ana  user's  program  to  completion  so  that  at  least  some  of 
the  user's  data  will  be  disolayed. 


E-l 


E-2 


E-3 


TABLE-III 
ERROR  DIAGNOSTIC  TABLE 

ELEMENT  BLOCK  ERROR  -  The.  spec i f i ed  routine  is  in 
error  in  one  of  two  respects.  Either  the  routine 
has  been  called  outside  a  draweleC)  block  when  it 
should  be  within,  or  the  routine  has  been  called 
within  a  draweleC)  block  when  it  should  be 
outside.  The  instruction  will  be  ignored  and 
control  returned  to  the  user's  program.  Block 
errors  have  a  tendency  to  occur  in  groups  when  the 
orogrammer  is  not  careful  in  constructing  element 
blocks. 

SPACE  ERROR  -  Space  allocated  by  the  system  for 
the  building  of  elements  has  been  exceeded.  See 
the  routine  remove  in  order  to  free  uo  unnecessary 
element  memory  locations.  The  instruction 
executing  when  this  error  occurs  will  be  ignored 
and  control  will  be  returned  to  the  user's 
program . 

DIRECTION  ERROR  -  The  value  of  the  parameter  'air' 
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E-u 


E-5 


E-o 


E-7 


was  not  C  or  CC  in  the  specified  routine.  A 
direction  of  C  will  be  assumed  and  the  routine 
will  continue  execution. 

CHARACTER  ERROR  -  A  character  symbol  included  in 
an  ASCII  character  string  is  undefined.  The 
symbol  will  be  ignored  and  control  will  be 
returned  to  the  user's  orogram. 

OBJECT  ERROR  -  The  named  object  does  not  exist;  it 
has  not  been  defined  in  a  call  to  the  routine 
objectO.  A  SDecification  of  a  non-existent 
object  will  terminate  the  routine  and  return 
control  to  the  user's  program. 

ELEMENT  ERROR  -  The  named  element  does  not  exist; 
it  has  not  been  defined  in  a  call  to  draweleOr 
chareleO/  or  printvO.  For  routines  that  specify 
a  number  of  element  names/  this  type  of  error 
normally  results  in  skipoinq  the  specified  element 
and  continuing  the  routine  with  the  next  element. 

DUPLICATE  ELEMENT  ERROR  -  An  element  name  has  been 
duo  Heated  in  a  draweleO  or  chareleO  call.  Each 
element  structure  created  by  draweleO  or 
chareleO  must  have  a  unique  name.  This  error 
usually  results  in  either  skipping  the  designated 
element  and  continuing  the  routine/  or  termination 
of  the  routine  and  return  to  the  user's  program. 
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ELEMENT  NUMBER  ERROR  -The  total  number  of  elements 
allowed  by  the  svstem  has  been  exceeded.  Maximum 
number  of  elements  allowed  is  70.  The  user  should 
consider  using  the  removed  routine  to  delete 
unnecessary  elements  so  new  elements  may  be 
i  nt  roduced . 
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OBJECT  NUMBER  ERROR  -  The  number  of  objects  allow- 
ed by  the  system  has  been  exceeded.  Maximum 
number  of  objects  is  10. 


E-10 


VECTOR  MODE  ERROR  -  Specified  vector  vmode  in 
setvectorO  routine  is  in  error.  A  vector  mode  of 
LN  will  be  assumed  and  the  routine  will 
execution.  See  the  setvectorO 
allowable  vector  mode  codes. 


cont  i  nue 
Summa  r y   for 
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DIMENSION  ERROR  -  The  coordinate  dimension  SDeci- 
fication is  in  error.  Either  the  'dim*  parameter 
in  coordsysO  is  in  error/  or  a  vector  type  of  VAZ 
or  VRZ  has  been  specified  with  a  two-dimensional 
coordinate  system.  The  routine  in  question  will 
be  skipped  and  control  returned  to  the  user's 
o  rogr am . 
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E-12 


E-13 


E-ia 


E-15 


E-16 


ADD  ELEMENT  ERROR  -An  error  has  occurred  in  cgetO 
op  objectO  in  attempting  to  build  a  new  element. 
Routine  terminates  and  control  is  returned  to  the 
user's  program . 

MAKE  OBJECT  ERROR  -  An  error  has  occurred  in 
cgetO  or  objectO  in  attempting  to  build  a  new 
object.  Routine  terminates  and  control  is 
returned  to  the  user's  program. 

VECTOR  TYPE  ERROR  -  An  improDer  vector  type  was 
soecified  in  routine  setvectorC).  >  A  vector  type 
of  VA  will  be  assumed  and  the  routine  will 
continue  executing.  See  the  setvectorC)  summary 
for  allowable  vector  tyoe  codes. 

X  COORDINATE/INCREMENT  ERROR  -  The  specified  x 
oarameter  exceeds  allowable  limits.  If  an 
absolute  x  coordinate  exceeds  the  defined 
coordinate  system,  the  x  value  will  be  set  to  the 
value  of  the  nearest  coordinate  within  the  defined 
system  Cxmin  or  xmax).  If  the  oarameter  specifies 
an  x  increment  which  exceeds  one-half  the 
coordinate  range;  the  parameter  is  set  to  zero. 

Y  COORDINATE/INCREMENT  ERROR  -  The  specified  y 
parameter  exceeds  allowable  limits.  If  an 
absolute  y  coordinate  exceeds  the  defined 
coordinate  svstem,  the  y  value  will  be  set  to  the 
value  of  the  nearest  coordinate  within  the  defined 
system  Cymin  or  ymax).  If  the  oarameter  specifies 
a  y  increment  which  exceeds  one-half  the 
coordinate  range/  the  parameter  is  set  to  zero. 


E-17 


Z  COORDINATE/INCREMENT  ERROR  -  The  specified  z 
parameter  exceeds  allowable  limits.  If  an 
absolute  z  coordinate  exceeds  the  defined 
coordinate  system,  the  z  value  will  be  set  to  the 
value  of  the  nearest  coordinate  within  the  defined 
system  (zmin  or  zmax).  If  the  oarameter  specifies 
a  z  increment  which  exceeds  one-half  the 
coordinate  range/  the  parameter  is  set  to  zero. 


E-16 


ELEMENT  NUMBER  ERROR 
cifying   the   number 


The  parameter  'num*  spe- 
of  elements  being  passed  in 
this  routine  is  not  -1  to  10.  A  'num'  value  of  10 
will  be  assumed  and  the  routine  will  continue 
executing. 
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CIR/APC  ERROR  -  A  circle  or  arc  cannot  be  drawn  by 
an  incremental  vector.  The  routine  is  skipped  and 
control  returned  to  the  user's  orogram. 


E-20 


USER  BUFFER  ERROR   -  The  size  of  the  supplied  user 
buffer  has  been  exceeded.   Either  enter  a  carriage 
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return  or  erase  (cntrl-a)  Dart  of  the  buffer. 

ADD  OBJECT  ERROR  -  An  error  has  occurred  in  cgetO 
or  objectO  in  attemoting  to  add  an  object  to  the 
disday.  Routine  terminates  and  control  returned 
to  the  user's  program. 


E-22 


E-23 


OBJECT  LINK  ERROR  -  The  specified  element  is  not 
linked  to  the  specified  object.  Error  usually 
results  in  skiooing  the  element  in  question  and 
continuing  the  routine  with  the  next  element. 

FUNCTION  SWITCH  NUMBER  ERROR  -An  imoroper  function 
number  was  soecified.  The  routine  terminates  and 
control  is  returned  to  the  user's  program.  A 
value  of  zero  is  returned  to  the  user. 


E-2U 


ACTION  VALUE  ERROR  -  An  imoroper  action  value  was 
soecified  in  this  routine.  Refer  to  routine 
summary  diagnostics  for  soecific  action  taken. 


E-25 


DIAL  NUMBER  ERROR  -  An  imoroper  dial  number  was 
soecified  in  routine  dialO.  The  routine 
terminates  and  a  value  of  0.0  is  returned  to  the 
user ' s  orogram . 


E-26 


ELEMENT  ERRCR  -Element  specified  in  printv  routine 
was  specified  earlier  as  other  than  a  printv 
element.  Routine  will  be  skipoed  and  control 
returned  to  the  user's  orogram. 
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DEVICE  NUMBER  ERROR  -An  improper  device  number  was 
used  in  this  routine.  For  sysinitO  a  device 
number  of  zero  will  be  assumed  and  the  routine 
will  continue.  For  cursorC)  or  oositC)  the 
routine  will  terminate  and  control  will  return  to 
the  user's  orogram.  The  oositC)  routine  will  also 
return  a  value  of  0.0  to  the  user. 


E-28 


COORDINATE  SPECIFICATION  ERROR  -  The  specification 
of  a  coordinate  in  this  routine  is  in  error.  The 
routine  terminates  and  a  value  of  0.0  is  returned 
to  the  user . 


E-29 


E-30 


E-31 


DIMENSION  ERROR  -  Neither  the  lightpen  nor  the 
trackball  have  a  z  coordinate  specification.  The 
routine  terminates  and  a  value  of  0'.  0  is  returned 
to  the  user . 

VALUE  ERROR  -  The  'val'  parameter  in  intscaleO  or 
intoffsetU*  or  the  'rate'  parameter  in  refreshO 
is  in  error.  The  routine  terminates  and  control 
returns  to  the  user's  program. 

CUT  ERROR   -   The  'cut'  parameter  in  intscaleO  is 
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not  zero   or   one.    The   routine   terminates 
control  returned  to  the  user's  program. 


and 


DUPLICATE  LINK  ERROR  -  The  specified  element  is 
al-   ready   linked   to   the   object.    The  routine 
continues   execution   with   the    next    specified 
e  1  ement . 


E-33 


E-34 


BUFFER  LIMIT  ERROR  -  Either  the  supplied  user  buf- 
fer has  been  filled  or  121  characters  have  been 
read  in  the  cgetO  routine.  The  routine  will  wait 
for  either  a  carriage  return  or  erasure  (cntrl-a) 
of  part  of  the  buffer  contents. 

FORMAT  ERROR  -  The  desired  output  string  exceeds 
100  characters  in  the  printvC)  routine.  The 
routine  will  print  only  the  first  100  characters. 


E-35 


WRITE  ERROR  -  The  write  direction  parameter  is  in 
error.  A  default  value  of  HOR  will  be  assumed  and 
the  routine  continued. 


E-36 


SLANT  ERROR  -  The  slant  parameter  is  in  error.  A 
default  value  of  NSLNT  will  be  assumed  and  the 
routine  continued. 


E-37 


SIZE  ERROR  -  The  size  Darameter 
default  value  of  SZ4  will  be 
routine  continued. 


is  in  error.    A 
assumed  and  the 
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APPENDIX  B 
USER  SUPPORT  ROUTINE  DESCRIPTIONS 

The  description  of  the  user  interface  routines  apoear  in 

a   format   similar  to   the  routine  descriptions  in  the  UNIX 

Reference  Manual  at  the  Naval  Postgraduate   School   Computer 
Laboratory  . 
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arc 


arc 


NAME: 


arc  -  draw  an  arc 


SYNOPSIS: 


2-di mens i ona 1  coordinate  system 

VR/VA   :  arc (di recent x , cent y,endx ,endy) 
VRX/VAX:  arc (di r,centy,endy ) 
VRY/VAY:  apc(dir,centx,endx) 
VRZ/VAZ:  not  al lowed 

3-di mens i ona 1  coordinate  system 

VR/VA   :  arc (di r, cent x , cent y , cent z , endx , endy , endz ) 
VRX/VAX:  arc(di  r, cent y ,cent z, endy/ endz) 
VRY/VAY:  arc(di  r , cent  x  , cent  z, endx, endz) 
VRZ/VAZ:  arc(di  r,centx/centy,endx,enay) 

int  dir:  CC  /  00a  -  counter  clockwise 
C  /  010  -  clockwi  se 

float  centx,centy,centz, endx, endy, endz," 


DESCRIPTION: 


An 

a  ce 
cent 
tyoe 
The 
the 
numb 
the 
vec  t 
t  anc 
po  i  n 
as  t 
f  rom 
end 


arc 
nter 
er  a 
and 
oara 
arc 
er  a 
vec  t 
op() 
e  fr 
t  ,  a 
he  r 
th 
DO  i  n 


is  drawn 
DO  i  nt  t 
nd  end  D 
sudd  1  i  e 
meters  o 
are  e  i  t  h 
nd  value 
or  t  yce 

If 
0"i  the  s 
n  arc  w  i 
adi  us . 
e   ac t ua 
t  . 


f  rom  the 
o  an  end  d 

0  i  nt  s  deoe 
d  center 
assed  for 

e  r  re  1  at  i  v 

of  these 
se 1 ec  t ed  i 
the  cent e 
t  ar t  i  ng  do 
1 1  be  draw 
The  result 

1  t  erm  i  na 


Dresen  t 
o  i  n  t  . 
nd  upon 
and  en 
the  cen 
e  or  ab 
pa rame t 
n  t  he  d 
r  do  i n  t 
int  of 
n  using 

i  s  a 
ting  do 


beam  1 
The  1 oc 

t  he  so 
d  DO  i  n 
t  er  and 
sol ut e 
ers  are 
rev  i  ous 

i  s  not 
the  arc 

one  of 
st  ra  i  gh 
int  of 


ocat 

at  i  o 

ec  i  f 

t   D 

end 

ua  1 

det 

cal 

an 

and 

the 

t   1 

the 


i  on  , 
n   o 
i  ed 
aram 

DO  i 
ues  . 
e  rm  i 
1  to 
eaua 
th 

d  i  s 
i  ne 
arc 


about 
f  the 
vector 
et ers . 
nt  s  of 
The 
ned  by 
set- 
1  di  s- 
e  end 
t  ances 

drawn 
to  t  ne 


If  the  vector  tyoe  is  an  absolute  vector,  the  center 
and  end  points  will  be  as  given  in  the  parameter  list. 
Aut o-i nc remen t  vector  tyoes  will  cause  the  center  and 
end  points  to  have  the  same  coordinate  value  as  the 
starting  do int  for  the  designated  auto- increment  coor- 
dinate. Under  absolute  vector  tyoes,  parameters  which 
fall  outside  the  defined  coordinate  system  will  assume 
a  value  of  the  nearest  coordinate  within  the  defined 
system. 


1  1  1 


arc 


arc 


If  the  vector  type  is  a  relative  vector/  the  end  point 
of  the  arc  will  be  obtained  by  adding  the  endx*  endy* 
and  endz  values  to  the  starting  point.  The  center 
point  is  then  obtained  by  adding  the  cent*,  centy*  and 
centz  values  to  the  oreviously  obtained  endooint.  As 
with  absolute  vectors*  auto-increment  modes  cause  the 
center  and  ena  ooints  to  have  the  same  coordinate 
value  as  the  starting  point  for  the  designated  auto- 
increment  coordinate.  Under  relative  vector  types* 
parameters  which  exceed  one-half  the  coordinate  range 
will  be  set  to  zero. 


Arcs   cannot 
vectors. 


be   drawn  by  any  of  the  four  incremental 


DIAGNOSTICS: 


All  errors  will  be   printed 
sc  reen  . 


on 


the   PDP-11   terminal 


ERROR    CAUSE 
E-l     Routine  has  been  called 

outsioe  a  draweleC)  block 
E-2     No  more  SDace  available 

in  diSDlay  list 
E-3     The  draw  direction  was  not 

def  i  ned  as  C  or  CC 
E-ll    3D  not  defined 
E-15    The  x  value  was  out-of-bounds 


E-16    The  y  value  was  out-of-bounds 
The  z  value  was  out-of-bounds 


E-l  7 


E-19 


Illegal  arc  instruction 
from  incremental  vector 


ACTION 
Return 

Return 

di  r  =  C 

Return 

x  =  x  m  i  n 

or  xma  x 

or  0.0 

y  =  ym  i  n 

or  ymax 

or  0.0 

z  =  zm  i  n 

or  zmax 

or  0.0 

Return 


ALSO  SEE: 

circle*  set  vec  tor 
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Ol  i  n* 


blink 


NAME: 


blink  -  blink  the  entire  oicture  or  the  specified 
object  or  elements 


SYNOPSIS: 

blink(action,num,,,objnaPen,,,eler',Nele2M, ,"elelO"); 

int  action:   ON  /  01    blink 

OFF  /  00    stop  blinkinq  action 

int  num:    PIC  /  00    oicture 
08J  /  -1    object 
1-10     el emen t  s 

To  blink  trie  entire  oicture: 

bl  i  n< (act  i  on,  PIC)  ; 
To  blink  a  specific  object: 

bl ink(action, OBJ, "obj name") ; 
To  blink  elements  of  a  sDecific  object: 

blinkCaction, num," obj name", " elel" ,"ele2",...); 

DESCRIPTION: 

The  blink  mode  for  the  entire  oicture/  a  sinqle  o  o  - 
ject  or  any  number  of  elements  of  a  specific  object, 
can  Oe  turned  on  or  off. 


Modifying  the  blink  mode  of  an  object  affects  a 
ments  linked  to  that  object. 


e  1  e- 


The  parameter  'num'  SDecifies  the  number  of  element 
names  oeing  passed  in  this  routine  and  can  vary 
between  1  and  10. 


DIAGNOSTICS: 


All   errors   will   be   printed   on  the  PDP-11  terminal 
sc  reen  . 


ERROR    CAUSE 
E-5     Specified  objname  does  not 
exist 


1  13 


ACTION 
Return 


bl  ink 


bl  ink 


E-6     Specified  element  does  not 

ex  i  st 
E-18    Parameter  'num'  not  -1  to  10 
E-22    Element  not  linked  to 

soec  i  f i  ed  ob  j  ect 
E-24    ImproDer  action  value 


Skip 

e 1 ement 
num  =  10 
Skip 

e 1 ement 
action  =  OFF 


1  1U 


cget 


cget 


NAME: 


cget  -  get  ASCII  characters  from  the  VG  keyboard 


SYNOPSIS: 

cget (buffer, lenath,xoos,ypos); 

Char  *bu f f erl 
i  nt  1 engt  h  ; 
float  xcos / vpos  ? 


DESCRIPTION: 


This  routine  allows  for  buffered  input  from  the  VG 
keyboard  to  be  displayed  on  the  display  screen  and 
inserted  in  a  user-supplied  buffer.  Parameters  allow 
for  the  positioning  of  the  display  buffer  on  the 
screen  in  absolute  coordinates.  The  length  of  the 
user-suoolied  buffer  must  be  specified  in  the  parame- 
ter '1 engt  h  '  . 

A   blinking   cursor   indicates   the   beginning  of  the 

ouffer  and  the   character   size.    Characters  may   be 

entered   into   the   buffer  and  onto  the  screen  up  to  a 

maximum  of  either  121  characters  or  the  size  of  the 
suoolied  user  buffer,  whichever  is  smaller. 

Contents  mav  be  erased  from  the  screen  and  the  user 
buffer  bv  reDeated  cntrl-a  keystrokes.  A  C/R  will 
terminate  the  input  strinp/  delete  the  display  of  the 
buffer  contents*  and  insert  a  '\0'  as  the  next  charac- 
ter in  the  user  buffer  to  indicate  termination  of  the 
s t  r  i  ng . 


A  listing  of  the  ASCII  character  code  for   every 
board  entry  is  listed  on  the  following  page. 


key- 


OIAGNOSTICS: 


All   errors   will   be   printed   on  the  PDP-11  terminal 
sc  reen . 


ERROR    CAUSE 
E-9     Object  limit  exceeded 
E-15    Soecified  xoos  out-of-bounds 


1  15 


ACTION 
Return 

xpos  =  xm  i  n 

or  xma  x 


cget 


cget 


E-16    Soecified  yoos  out-of-bounds 

E-20    Either  121  characters  entered 
or  user  buffer  limit  reached 


ypos  =  ymin 

or  ynax 

Wait  for  CR 

or  CNTRL-A 


ALSO  SEE: 

i  get  t     f get 


VG 

OCTAL 

CHARACTER 

GENERATED 

KEYBOARD 

CODE 

SYMBOL 

SY 

MBOL 

000 

NULL 

( i  gnored) 

a 

Ctrl 

001 

SO      erase  last  char . 

A 

Ctrl 

002 

STX 

( i  gno  red) 

B 

Ctrl 

003 

ETX 

( i  qnored) 

C 

Ctrl 

004 

EOT 

C  i  gnored) 

D 

Ctrl 

005 

ENQ 

( i  gno  red ) 

E 

ct  r  1 

006 

ACK 

( i  gnored ) 

F 

ct  r  1 

007 

BEL 

C  i  gnored ) 

G 

ct  rl 

010 

BS 

BS 

01  1 

HT 

(LF,  cent) 

I 

Ctrl 

012 

LF 

LF 

013 

VT 

( t op  f    cent  ) 

K 

Ctrl 

014 

FF 

( top,  left) 

L 

ct  r  1 

015 

NL 

(CR,  LF) 

CF 

} 

016 

SE 

(  i  gnored) 

N 

Ctrl 

017 

SI 

( i  gnored ) 

0 

Ctrl 

020 

OLE 

(clear  queue ) 

P 

Ctrl 

021 

DC1 

(-LF) 

Q 

Ctrl 

022 

DC2 

(-SZ) 

R 

Ctrl 

023 

DC3 

(+SZ) 

S 

Ctrl 

024 

DC4 

(terminate) 

T 

Ctrl 

025 

NAK 

( i  gno  red ) 

U 

Ctrl 

02o 

SYN 

( i  ano  red ) 

V 

Ctrl 

027 

ETB 

( i  gno  red ) 

H 

Ctrl 

030 

CAN 

( i  qnored ) 

X 

Ctrl 

031 

EM 

( i  gno  red ) 

Y 

Ctrl 

032 

SUB 

( i  gno  red ) 

z 

Ctrl 

033 

ESC 

( escape) 

[ 

ct  rl 

034 

PS 

( i  qnored ) 

\ 

Ctrl 

0  35 

GS 

( i  gno  red) 

] 

Ctrl 

036 

RS 

( i  gno  red ) 

A 

ct  rl 

037 

US 

( i  gno  red ) 

.Ctrl 

040 

Soace 

sp  bar 

041 

i 

1 

shi  ft 

042 

n 

2 

shift 
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cget 


cget 


0a3 

n 

044 

$ 

045 

% 

046 

& 

047 

» 

050 

( 

051 

) 

052 

* 

053 

♦ 

054 

* 

055 

- 

056 

• 

057 

/ 

060 

0 

061 

i 

062 

2 

063 

3 

064 

4 

065 

5 

066 

6 

067 

7 

070 

8 

071 

9 

072 

• 
• 

073 

} 

074 

< 

075 

- 

076 

> 

077 

7 

100 

3 

101 

A 

102 

B 

103 

C 

104 

D 

105 

E 

106 

F 

107 

G 

110 

H 

111 

I 

1  12 

J 

113 

K 

1  14 

L 

115 

M 

1  16 

N 

117 

0 

120 

P 

121 

Q 

122 

R 

123 

S 

124 

T 

125 

U 

126 

V 

3 

shi 

ft 

4 

shi 

ft 

5 

shi 

ft 

6 

shi 

ft 

7 

Shi 

ft 

8 

shi 

ft 

9 

shi 

ft 

• 

Shi 

ft 

• 
t 

shi- 

ft 

/ 

0 

I 

2 
3 
4 
5 
6 
7 
8 


1 

shi 

ft 

- 

shi 

ft 

• 

sh  i 

ft 

/ 

sh  i 

ft 

a 

A 

shi 

ft 

B 

sh  i 

ft 

C 

Shi 

ft 

D 

Shi 

ft 

E 

shi 

ft 

F 

sh 

ft 

G 

sh' 

ft 

H 

Sh 

'  ft 

I 

Sh 

i  ft 

J 

Sh 

i  ft 

K 

Sh 

i  ft 

L 

Sh 

i  ft 

M 

Sh 

i  ft 

N 

sh 

i  ft 

0 

Sh 

i  ft 

P 

Sh 

i  ft 

Q 

sh 

i  ft 

R 

sh 

i  ft 

S 

sh 

i  ft 

T 

sh 

i  ft 

U 

sh 

i  ft 

V 

sh 

i  ft 
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cget 


127 
130 
131 
132 
133 

W 
X 
Y 

Z 
( 

X 
Y 
Z 
[ 

shift 
shift 
shi  ft 
shift 

13a 

\ 

\ 

135 

] 

J 

136 

A 

( suoersc  ri  pt ) 

A 

137 

— 

( subsc  r  i  pt  ) 

aa 

140 
1  a  l 

a 

a 

A 

shi  ft 

142 

b 

B 

143 

c 

C 

144 

d 

0 

145 

e 

E 

146 

f 

F 

147 

g 

G 

150 

h 

H 

151 

i 

I 

152 

J 

J 

L53 

k 

K 

154 

1 

L 

155 

IV 

M 

156 

n 

N 

157 

0 

0 

160 

D 

P 

161 

q 

0 

162 

r 

R 

163 

s 

S 

164 

t 

T 

165 

u 

U 

166 

V 

V 

167 

w 

w 

170 

X 

X 

171 

y 

Y 

172 

2 

Z 

173 

{ 

[ 

Shift 

174 

• 
i 

\ 

Shift 

175 

} 

1 

shift 

176 

** 

A 

shift 

177 

del 

DEL 

240 

0 

space  spec 

241 

» 

1 

shift  spec 

242 

tf 

2 

shift  spec 

243 

0 

3 

shift  spec 

244 

I 

4 

shift  spec 

245 

V 

(cent  ered) 

5 

shift  spec 

246 

s 

6 

shift  soec 

247 

r 

7 

shift  soec 

250 

c 

8 

shift  spec 

251 

3 

9 

shift  spec 

252 

to 

( subsc  r  i  pt  ) 

1  18 

• 
• 

shift  spec 

cget 


cqet 


253 

• 

T 

25a 

« 

255 

a 

256 

& 

257 

n 

260 

o 

261 

t 

262 

* 

263 

□ 

26M 

* 

265 

A 

(centered) 

266 

9 

267 

X 

270 

u 

271 

n 

272 

* 

(center  do 

273 

X 

27a 

«• 

315 

19 

316 

»\ 

317 

A 

320 

ir 

321 

o 

322 

* 

323 

£ 

32a 

9 

325 

1 

326 

f 

327 

A 

330 

r 

331 

r 

332 

— 

333 

L 

33a 

^ 

335 

K 

33o 

— 

337 

• 

3ao 

UJ 

(b 1  inking) 

341 

6 

3a2 

* 

3a3 

7 

3aa 

s 

3a5 

e 

3ab 

* 

3a7 

y 

350 

i. 

351 

L 

352 

N 

353 

/ 

35a 

X 

355 

M 

356 

V 

• 

shift 

spec 

t 

spec 

- 

spec 

• 

spec 

/ 

spec 

0 

spec 

1 

spec 

2 

spec 

3 

spec 

a 

spec 

5 

spec 

6 

spec 

7 

spec 

8 

spec 

9 

spec 

• 
• 

spec 

• 

spec 

$ 

shi  ft 

spec 

M 

shift 

spec 

N 

shi  ft 

soec 

0 

shi  ft 

spec 

P 

shi  ft 

spec 

Q 

shift 

spec 

R 

shift 

spec 

S 

shi  ft 

spec 

T 

shi  ft 

spec 

U 

shift 

spec 

V 

shift 

spec 

w 

Shi  ft 

spec 

X 

Shi  ft 

spec 

Y 

shift 

spec 

Z 

shift 

spec 

[ 

spec 

\ 

spec 

1 

spec 

As 

spec 

mmm 

spec 

a 

shi  ft 

spec 

A 

soec 

B 

spec 

C 

spec 

0 

spec 

E 

spec 

F 

spec 

G 

spec 

H 

spec 

I 

spec 

J 

spec 

K 

spec 

L 

spec 

M 

soec 

N 

spec 
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357 

w 

360 

T 

361 

& 

362 

e 

363 

T 

364 

r 

365 

5 

366 

o 

367 

J 

370 

• 
• 

371 

4 

372 

V 

373 

r 

37a 

i 

375 

^ 

37b 

-— « 

377 

M 

0 

p 

Q 
R 
S 
T 
U 
V 
to 
X 
Y 
Z 
[ 
\ 
] 


spec 
spec 
spec 
spec 
spec 
spec 
spec 
spec 
spec 
spec 
spec 
spec 
spec 
spec 
spec 
spec 


shift 
shift 
shift 
shi  ft 


DEL  spec 
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charel e 


NAME: 


charele  -  displays  an  ASCII  character  string 
on  the  Vector  General 


SYNOPSIS: 


charele("elename,,/Charptr,size,wdir,slant,xpos,ypos); 


i  n t  size: 


1  nt 


idi  r 


i  n  t  slant 


SZ   / 

0000 

SZ1  / 

0100 

SZ2  / 

0120 

SZ3  / 

o  i  ao 

SZU  / 

0160 

HOP  / 

0000 

VER  / 

0200 

SLNT 

/  00 

NSLN1 

/  01 

use  previous  character  size 
size  =  100  col  x  60  1  i  nes 
size  =  81  col  x  a  1  1 i  nes 
sixe  =  60  col  x  30  lines 
size  =  32  col  x  16  1  i  nes 

write  horizontally 
write  vertically 

slant  c  harac  ters 
no  slant  characters 


float  xoos;  ycos ; 


xpos:   VGREL  - 


to  output  characters  relative 
to  the  present  beam  position 
the  parameter  xpos  should  be 
replaced  with  VGREL  and  the 
oarameter  ypos  omitted. 


DESCRIPTION: 


This  routine  displays  the  ASCII  character  string, 
soecified  by  charptr,  on  the  vector  general  screen. 
The  characters  can  be  output  by  specifying  the  desired 
coordinate  starting  point  (xpos,yoos)  or  by  outputting 
the  string  relative  to  the  oresent  beam  location.  The 
symbols  available  include  formatting  symbols  and  an 
extended  character  set.  These  can  be  included  in  any 
character  string  by  including  the  oroper  identifying 
symbols.  The  character  string  formatting  symbols  are: 


KEYBOARD 
SYMBOL 


FORMAT 


*A 

«c 


backsoace?  moves  back  one  character  space 

line  feed»  position  center  screen 

1 i  ne  feed 

position  at  too  center  of  screen 

position  at  too  left  corner  of  screen 

carriage  control »  line  feed 


12i 
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UP 
#1 


i  gnored 

i  gnorea 

spec  i  a  1  charact er 

neg.  line  feed;  moves  uo  one  line 

decreases  current  character  size  by  one 

increases  current  character  size  by  one 


Oue  to  the  extenaed  character  set  available  on  the 
vector  general^  all  special  character  symbols  are  pre- 
ceded bv  a  pound  sign.  In  order  to  have  a  pound  sign 
apoear  on  the  screen,  two  pound  signs  («#)  must  appear 
in  the  character  string.  A  list  of  the  special  char- 
acters available  are  listed  on  the  next  page  under 
Extended  Character  Set. 


DIAGNOSTICS: 


All  errors  will  be   printed   on   the   PDP-11   terminal 
sc  reen . 


ERROR    CAUSE 
E-l     Routine  has  been  called 

within  a  draweleC)  block 
E-2     No  space  available  in 

di  so  1  ay  list 
E-4     Incorrect  ASCII  character  symbo 

found  in  character  string 
E-7     Duplicate  element  name 
E-B     Maximum  number  of  elements 

exceeoed 
E-15    Specified  xpos  out -o f -bounas 

E-16    Soecified  ypos  out-of  bounds 

E-35    Improper  'wdir'  parameter 
E-3b    Improper  'slant'  parameter 

E-37    Imorcper  'size'  parameter 


ACTION 
Return 

Return 

None 

Return 
Return 

xpos  =  xm i  n 
or  xma  x 

ypos  =  ym  i  n 
or  y ma  x 

write  =  HOR 

slant  = 

NSLNT 

size  =  SZ4 
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Extended  Character  Set 


DATAMEDIA 
KEYBOARD 
SYMBOL 


CHARACTER 


tf space 
si 

9* 

«L 

*$ 
#H 
#& 

n% 

«( 
*) 

»* 
«  + 
n, 

9" 
*. 

9/ 

90 
9\ 
92 
*Z 

4a 
#5 


a 

O 

£ 
y 

/ 

cz. 


> 

-I 

o 

f 
D 

A 
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charele 


ttb 
*7 
#8 
aq 

#: 
ft; 

tt< 

*M 
*N 
*0 
*P 
»Q 
*R 

as 

#U 

av 
aw 
ax 

sY 
#2 
8  [ 
a\ 

a] 

at 

a«- 


i 
v 
n 


n 
T 

4> 
1 

; 

A 
f 

L 


12a 


charel e 
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circle 


circle 


NAME: 


ci  re  1 e  -  draw  a  c  i  rcl  e 


SYNOPSIS: 


2-di mens i ona 1  coordinate  systei 


VR/VA 
VRX/VAX 
VRY/VAY 
VRZ/VAZ 


ci  rcleCdi  r,centx,centy) ; 
c  i  re  1  e(di  plenty  )  ; 
c  i  re  1 e  Cdi  r , cent x ) ; 
not  all  owed 


3-d i mens i ona 1  coordinate  system 


VR/VA 
VRX/VAX 
VRY/VAY 
VRZ/VAZ 

i  n  t  d  i  r  : 


circle(dir,centx,centy,centz); 
ci  rcle(di  r,centy,centz) ; 
ci  re  1 e(di  r,centx,centz) ; 
ci  rcleCdi  r»centx,centy)  ; 


C  /  010    clockwise 
CC  /  004    counter-clockwise 


float  cent x  ,  cent y  ,  cent z ; 


DESCRIPTION: 


A  circle  is  drawn  from  the  oresent  beam  location  about 
a  center  ooint.  The  location  of  the  center  ooint 
depends  uoon  the  s  d  e  c  i  f  i  e  d  vector  type  and  supplied 
center  ooint  oarameter.  The  parameters  passed  for  the 
center  ooint  of  the  circle  are  either  relative  or 
absolute  values.  The  number  and  value  of  these  param- 
eters are  determined  by  the  vector  type  selected  in 
the  previous  call  to  setvectorO. 

If  the  vector  type  is  an  absolute  vector  then  the 
center  ooint  of  the  circle  will  be  as  given  in  the 
oarameter  list.  Auto-increment  vector  tyoes  will 
cause  the  center  ooint  to  have  the  same  coordinate 
value  as  the  starting  point  for  the  designated  auto- 
increment  coordinate.  Under  absolute  vector  tvoesr 
parameters  which  fall  outside  the  defined  coordinate 
system  will  assume  a  value  of  the  nearest  coordinate 
within  the  defined  system. 

If  the  vector  tyoe  is  a  relative  vector  the  center 
ooint  will  be  obtained  by  adding  the  centx*  centy,  and 
centz  values  to  the  start ina  point.  As  with  absolute 
vectors*  auto- increment  modes  cause  the  center  point 
to  have  the  same  coordinate  value  as  the  starting 
ooint   for   the   designated  auto-increment  coordinate. 
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circle 


Under  relative  vector  tyoes,  parameters   which   exceed 
one-half  the  coordinate  range  will  be  set  to  zero. 

Circles  cannot  be  drawn  by  any  of  the  four  incremental 
vec  tors. 


DIAGNOSTICS: 


All   errors   will   be   orinted   on  the  PDP-11  terminal 
sc  reen . 


ERROR    CAUSE 
E-l     Routine  has  been  called 

outside  a  draweleC)  block 
E-2     No  SDace  available  in 

display  list 
E-3     Draw  direction  not  defined 

as  either  C  or  CC 
E-l  1    3D  not  def  i  ned 
E-15    The  x  value  was  out-of-bounds 


E-lb    The  y  value  was  out-of-bounds 
The  z  value  was  out-of-bounds 


E-l  7 


E-19 


Illegal  circle  instruction 
from  incremental  vector 


ACTION 
Return 

Return 

cm  r  =  C 

Return 

x  =  xm  i  n 

or  x  ma  x 

or  0.0 

y  =  ymi  n 

or  ymax 

or  0.0 

z  =  zm  i  n 

o  r  zmax 

or  0.0 

Return 


ALSO  SEE: 

a  re /  set  vec  t  or 
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cl rhi  t 


NAME: 


clrhit  -  clear  p  i  ct  ure/ob  j  ec  t  /e  1  emen  t  Hghtpen  hit 


SYNOPSIS: 

clrhit(num,"objname",,'elename"); 

int  num:   PIC  /  00    clear  all  element  lightpen  hits 
OBJ  /  -1    clear  liqhtpen  hits  on  all 

elements  of  specified  object 
ELE  /  +1    clear  liqhtoen  hit  on  specified 

element  of  specified  object 

To  clear  all  elements  of  liqhtpen  hits: 

clrhit(PIC); 
To  clear  all  elements  of  object  'tree': 

cl  rhi  t  (OBJ,  "tree")  ', 
To  clear  element  'branch5'  of  object  'tree': 

cl rhi  t (ELE, "tree", "branch 5") ; 

DESCRIPTION: 

This  routine  clears  liqhtoen  hits  on  a  sinqle  element, 
group  of  elements,  or  all  elements.  If  PIC  is  speci- 
fied, all  elements  are  cleared  of  liqhtpen  hits.  If 
OBJ  is  soecified/  all  elements  attached  to  the  speci- 
fied object  are  cleared  of  liqhtpen  hits.  If  ELE  is 
specified,  only  the  indicated  element  of  the  specified 
object  is  cleared  of  a  liahtpen  hit.  Invalid  oarame- 
ters  will  result  in  no  action  being  taken. 

DIAGNOSTICS: 

All  errors  will  be  orinted  on  the  PDP-11  terminal 
sc  reen  . 


ERROR  CAUSE 
E-5     Indicated  objname  does  not 

exist 
E-6     Indicated  elename  does  not 

exist 
E-22    Element  not  linked  to 

soecified  object 


ACTION 
Return 

Return 

Return 
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coordsy s 


NAME: 


coordsys  -  define  user  coordinate  systei 


SYNOPSIS: 

coordsys(dim,minx,maxx,miny,maxy     [,(ninz,maxzl     ); 
int    dim:       2.    or    3 

float    Tunx,maxxfminy.maxy,minz>T>axz; 

DESCRIPTION: 

Defines  a  two  or  three  dimensional  cartesian  coordi- 
nate system,  of  any  scale,  for  the  user.  The  parameter 
'dim'   soecifies  the  number  of  dimensions  required.  If 


'dim'  is  2  then  only  the  range  of 
soec  i  f  i  ed. 


and  y  need   to   be 


minx  must  be  strictly  less  than  maxx. 

miny  must  be  strictly  less  than  maxy. 

minz  must  be  strictly  less  than  maxz. 

All  subsequent  user  coordinate  values  are  interpreted 
according  to  this  user  defined  coordinate  system. 

If  coordsysO  is  not  called  by  the  user  the  default 
values  will  be  taken.  The  default  coordinate  system  is 
three  dimensional  with  x,  y,  z  ranging  from  -100.0  to 
100.0.  All  coordinate  values  received  will  be  inter- 
oreted  accoraing  to  these  default  values  unless  the 
coordinate  system  is  redefined  by  the  user. 


DIAGNOSTICS: 


Any  values  which  fall  outside  of  the  defined  coordi- 
nate svstem  will  oroduce  an  error  message  specifying 
which  coordinate  value  was  out-of-bounds.  If  the 
value  was  an  absolute  coordinate,  the  nearest  coordi- 
nate within  the  defined  coordinate  system  will  be 
assumed.  If  the  value  was  a  relative  value  that  was 
ou t -o f -bounds #  a  value  of  zero  will  be  assumed. 


All   errors 
sc  reen . 


will   be   printed   on  the  PDP-11  terminal 
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coordsys 


ERROR 
E-ll 


CAUSE 

D  i  mens  i  on 

2D  or  3D 


not  soec  i  f  i  ed  as 


ACTION 
Return 
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conve 1 e 


NAME: 

copyele  -  soecify  additional  names  to  Oe  used 

in  referencing  a  specific  element  block 

SYNOPSIS: 

copvele(num,Helename"  ,"namel"  ,"name2",....f"narnel0"); 
i  nt  num :    1  to  1 0 

DESCRIPTION: 

This  routine  allows  the  user  to  give  several  unigue 
names  to  a  specific  element  block.  In  this  manner,  a 
user  can  link  one  element  to  an  object  several  times 
and  can  uniauely  reference  each  occurrence  of  the 
element  within  the  object. 

The  parameter  'num'  SDecifies  the  number  of  element 
names  being  passed  in  this  routine  and  can  vary 
between  1  and  1 0 . 

DIAGNOSTICS: 

All  errors  will  be  printed  on  the  PDP-11  terminal 
sc  reen . 


ERROR    CAUSE 
E-6     Soec i f i ed  elename  does  not 

exist 
E-7     Duplicate  element  name 

E-S     Maximum  number  of  elements 

exc  eeded 
E-18    Parameter  'num'  not  1  to  10 


ACTION 
Return 

Skip 

e 1 emen t 
Return 

num  =  1 0 


ALSO  SEE: 

drawele,  object 
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cursor 


NAME: 


cursor  -  activate/deactivate  display  of  specified 
dev  ice  cursor 


SYNOPSIS: 

cursor(oev,act  ion) ; 

int  dev:  LPEN  /  00 
TRK  /  01 
JOY  /  02 

int  act  i  on  :   OFF  /  00 
ON  /  01 


1 i  ah  t pen 
t  rackba 1  1 
j  oy s t  i  c  < 

turn  cursor  disolay  off 
turn  cursor  display  on 


DESCRIPTION: 


This  routine  will  activate/deactivate  the  aisplay  of 
the  soecified  device  cursor  depending  on  the  specified 
'action'  value. 

The  trackball  and  joystick  cursors  are  displayed  as 
olinking  plus  signs.  The  trackball  cursor  is  two 
dimensional  ana  may  be  moved  along  the  X-Y  plane.  The 
joystick  cursor  is  drawn  two  d i mens i ona 1 1 y  but  can 
move  in  all  three  dimensions.  As  the  joystick  cursor 
moves  along  the  Z  axis  its  intensity  cueing  is  affect- 
ed. Both  trackball  and  joystick  cursors  may  be  moved 
without  being  disolayed. 

The  lightoen  cursor  is  a  small  non-bl inking  octogon. 
It  is  drawn  in  two  dimensions  and  car  only  move  aiong 
the  X-Y  Diane.  The  lightoen  m  a  v  o n  1  v  be  moved  while 
beina  displayed.  LightDen  cursor  movement  mav  be 
accomplished  in  one  of  two  speeds*  depending  upon 
whetner  the  lightoen  sense  switch  is  on. 


DIAGNOSTICS: 


All   errors 
sc  reen  . 


ill   be   Drinted   on  the  PDP-11  terminal 


ERROR 
E-2U 
E-27 


CAUSE 

ImoroDer 

Imorooer 


'action'  value 
' dev '  numbe  r 


ACTION 
Return 
Return 
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dial 


NAME: 


dial  -  return  value  of  specified  di 


SYNOPSIS: 

di  a  1  ( num ) ? 

i  n  t  n  u  m :    1-10 
doubl  e  dialO; 

DESCRIPTION: 

This   routine   returns  to  the  user  a  double  precision 

value  from  -1.0  to  +1.0  of  the  SDecified  dial.   A  zero 

(0)  is  returned  to  the  user  if  an  improper  dial  'num' 
i  s  soec  i  f  i  ed . 

To  obtain  the  double  precision  value  from  this  routine 
the  function  declaration  "double  d  i  a  1  ( ) ? "  must  be  made 
in  the  users  program. 

DIAGNOSTICS: 

All  errors  will  be  printed  on  the  PDP-11  terminal 
sc  reen  . 


ERROR    CAUSE 
E-25    Improper  dial  'num' 


ACTION 
Return  0.0 
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NAME: 


display  -  activate/deactivate  display  of  the  entire 
picture*  an  object,  or  an  element 


SYNOPSIS: 

di  sdI ay (act  i  on, type, "ob jname" , "el  el " , . . . .  , "el elO" ) ; 

int  action:   ON  /  01    turn  disDlav  on 
OFF  /  00    turn  display  off 

int  tyoe:   ?IC  /  00    entire  picture 

OBJ  /  -1    specified  object 
1  -  10     individual  elements 

To  activate  aisolay  of  entire  picture: 

di  spl ay (ON, PIC) ; 
To  deactivate  display  of  an  object: 

ai  spl ay (OFF, 08J, "ob j name" ) ; 
To  deactivate  display  of  3  elements  in  an  object: 

d  i  so  1  a y ( OFF , 3 , " ob  j  n ame " , " e 1 e 1 M , " e 1 e2 " , " e 1 e 3 " ) ; 

DESCRIPTION: 

This  routine  will  activate  or  deactivate  the  display 
of  the  entire  picture,  an  object,  or  elements  within 
an  object  depending  upon  the  'action'  parameter. 
Unlike  the  erase()  and  removeO  routines,  this  routine 
does  not  affect  the  element-object  re  1  a t i onsh i os  ,  but 
simply  turns  the  display  of  its  parameters  either  on 
or  off.  The  routine  should  not  be  confused  with  the 
vgoicture()  routine  which  must  be  called  to  initiate 
the  display  of  elements. 


DIAGNOSTICS: 


All  errors  will  be 
sc  reen  . 


orinted   on   the   PDP-11   terminal 


ERROR 
E-5 
E-6 


CAUSE 

Specified  objname  not 

Soec i f i ed  element  not 
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found 
found 


ACTION 
Return 
Skip 

e 1 emen t 


di  so  1  ay 


display 


E-18    Parameter  ' tyoe'  not  -1  to 
E  -  2  2    Element  not  linked  to 
soec  i  f  i  ed  ob j  ect 


10 


type  =  10 
Skip 

el ement 


ALSO  SEE: 

vgoicture*  erase/  remove 
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drawe 1 e 


NAME: 


drawele  -  start  a  draw  element  block 


SYNOPSIS: 

drawele(Hel ename" ) ; 

DESCRIPTION: 

This  routine  s  o  e  c  i  f  i  e  s  the  b  e  q  i  n  n  i  n  q  of  a  draw  element 
block.  It  associates  a  unique  name  with  the  qrouo  of 
draw  instructions  that  fall  in  between  this  call  and  a 
call  to  endeleO  •  The  resultinq  picture  segment  will 
then  be  referenced  oy  the  name  scecified  as  the  ele- 
ment name  in  this  routine. 

A  user  mav  want  to  reoeat  a  specific  element  block 
structure  several  times  within  one  object.  Instead  of 
specifying  several  element  blocks  which  describe  the 
same  structure  a  user  can  indicate  a  group  of  names 
which  refer  to  one  soecific  element  block.  These 
uniaue  names  each  referrinq  to  the  same  structure  can 
then  be  linkea  to  an  object/  and  each  can  oe  uniquely 
referenced.  This  association  of  several  names  with  one 
element  can  be  accomplished  by  the  routine  copyeleO. 

DIAGNOSTICS: 


All  errors  will 
sc  reen . 


be   orinted   on   the   PDP-11   terminal 


ERROR    CAUSE 
E-1     Routine  has  been  called 

within  a  drawele()  block 
E  -  2     No  space  available 

in  display  list 
E-7     Duplicate  element  name 
E-8     Maximum  number  of  elements 

exceeded 


ACTION 
Return 

Return 

Return 
Return 


ALSO  SEE: 

cooye le»  ob  j  ec  t 
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NAME: 


endele  -  end  of  the  current  element  block 


SYNOPSIS: 

endel e ( ) ; 

DESCRIPTION: 


Specifies  the  termination  of  a  list  of  draw  instruc- 
tions describing  a  SDecific  element.  The  picture  seg- 
ment described  by  a  grouo  of  draw  instructions  that 
fall  between  a  draweleC)  and  endeleO  call  will  be 
referenced  by  the  name  specified  in  the  draweleC) 
call. 

A  new  element  block  cannot  oegin  until  the  previous 
block  has  been  properly  terminated  by  a  call  to  en- 
deleO. 


DIAGNOSTICS: 


This  routine  must  be  called  to  properly  end  a  draw 
element  block.  If  a  block  is  not  properly  terminated 
prior  to  the  beginning  of  a  new  element  block/  all 
draweleC)  calls  will  be  ignored  and  any  araw  instruc- 
tions that  follow  will  be  associatea  with  the  element 
block  that  has  not  been  terminated. 


All   errors 
sc  reen  . 


will   be   printed   on  the  PDP-11  terminal 


ERROR    CAUSE 
E-l     Routine  has  been  called 

outsioe  a  draweleC)  block 


ACTION 
Return 
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NAME: 


erase  -  erase  the  specified  portions  of  the  pictun 


SYNOPSIS: 

erase(num,"ob j name ","e lei" , "e 1 e2 " , . . . .,  "  e  1  e  1  0  "  )  ; 

int  num:    PIC  /  00    all  elements 

OBJ  /  -1    all  elements  within  specified 
ob j  ec t 
1  "  1ft     soecified  elements  within 
soec  i  f  i  ed  object 

To  erase  the  entire  picture: 

erase(PIC)  ; 
To  erase  a  specific  object: 

erase(OBJ,"objnameH); 
To  erase  elements  of  a  specific  object: 

erase (num, "ob jname" , "el  el" , "el e2",  .  . ) ; 

DESCRIPTION: 

The  entire  picture,  specified   object  or   the   listed 

elements  of  a  specific  object,  will  be  erased  from  the 

vector  general   display   screen.   The  elements   still 

exist.  To  reaisolay  any  oortion  of  the  erased  picture, 

the  appropriate  e  1  e<*en  t  -ob  j  ec  t  linkinq  must  again  be 
done  by  the  user. 

The  parameter  'num'  specifies  the  number  of  element 
names  being  passed  in  this  routine  and  may  vary 
between  1  and  1 0 . 

DIAGNOSTICS: 

All  errors  will  be  printed  on  the  PDP-11  terminal 
sc  reen . 


ERROR  CAUSE 
E-5     Soecified  objname  does  not 

exist 
E-6     Specified  element  does  not 

exist 


ACTION 
Return 

Skip 

e 1 emen  t 
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erase 


erase 


E-18    Parameter  'num'  not  -1 
E-22    Element  not  linked  to 
soec  i  f  i  ed  ob  j  ec t 


to  10 


num  =  10 
Skip 

e 1 ement 


ALSO  SEE: 

remove;  d  i  s  o  1  a  y  >  object 


lao 


er  ro rmsg 


er  rormsg 


NAME: 


erro rmsg  - 


print  error  messages  on  PDP-11  terminal 
sc  reen 


SYNOPSIS: 

er rormsg (action); 

i  nt  act  i  on  :    ON  /  0  I 
OFF  /  00 


print  error  messages 

do  not  orint  error  messages 


DESCRIPTION: 


All  error  messages  will  automatically  be   printed   on 

the   DDP-11   terminal  screen.  The  user  can  control  the 

printing  of  error  messages  during   any  portion   of   a 
program  by  calling  this  routine. 
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NAME: 


fget  -  get  a  floating  point  number  from  the  VG 
keyboard 


SYNOPSIS: 

fget(  [nuniiXDoSfVpos]  ); 

int  num:   ABS  /  01    absolute  coordinate  indicator 

float  xooSfVDOs;     (x,y)  absolute  coordinate 

To  return  a  floating  ooint  number  and  begin  inout 
disolay  Duffer  at  (50.0,75.0)  absolute: 

rget ( ABS , 50 . 0 ,  75 . 0 ) ; 

To  return  a  floating  point  number  and  begin  input 
display  buffer  at  (xmin,ymin)  absolute: 

fget  (); 

DESCRIPTION: 

This  routine  returns  to  the  user  a  floating  ooint 
number  from  the  VG  keyboard.  The  routine  is  similar 
to  getf()  and  in  fact  uses  getf()  to  accomplish  its 
task. 

The  ootional  oarameters  allow  the  user  to  position  the 
input  disDlav  buffer  anywhere  on  the  display  screen. 
The  'xoos'  and  'yoos'  parameters  are  absolute  floating 
point  coordinates.  If  no  parameters  are  given  the 
inout  Puffer  will  begin  at  (xmin,ymin).  Coordinate 
oarameters  which  fall  outside  the  defined  coordinate 
system  will  assume  a  value  of  the  nearest  coordinate 
within  the  defined  system. 

The  input  display  buffer  is  drawn  with  the  help  of   a 

call   to  the  cgetC)  routine.   The  input  display  buffer 

has  a  maximum  size  of  20  characters  before  an  error 
message  is  displayed. 

To  obtain  the  floating  ooint  value  from  this  routine 
the  function  declaration  "float  fgetO;"  must  be  made 
in  the  users  crogram. 


1U2 


fget 


fqet 


DIAGNOSTICS: 


All  errors  will  be   printed   of   the   PDP-11   terminal 
sc  reen . 


ERROR    CAUSE 
E-15    Soec i f i ed  xdos  out-of-bounds 

E-16    Soecified  yDos  out-of-bounds 

E-33    Buffer  limit  of  20  characters 
reached 


ACTION 

xpos  s  xm  i  n 

or  xmax 
ypos  =  ym  i  n 

or  ymax 

Wait  for  C  R 

or  CNTRL-A 


ALSO  SEE: 


i  get  t    cget 
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f  sman 


NAME: 


fsman  -  check  function  switch  depressed 


SYNOPSIS: 

f  sman ( num ) ; 

i  nt  num  :   0-31 


DESCRIPTION: 


This  routine  checks  the  status  of  the  specified  func- 
tion switch  and  returns  a  one  (1)  if  depressed  and  a 
zero  (0)  if  not  depressed.  Unlike  f  stoqO;  lamps  are 
not  lighted  by  this  routine  and  a  one  is  returned  only 
so  long  as  the  switch  is  physically  depressed. 

It  is  not  recommended  that  both  fstogO  and  fsmanC)  oe 
used  in  the  same  program.  Oue  to  the  operation  of  the 
routine  fstogf)/  if  both  routines  are  used  the  lamp 
status  on  switches  Queried  by  fsmanC)  should  be  disre- 
ga  rded . 


zero   is   returned   if   an  improper  function  switch 
num'  is  soecified. 


DIAGNOSTICS 


All  errors  w  i 
sc  reen . 


be   printed 


on 


ERROR    CAUSE 
E  -  2  3    Improoer  function  switch 
• num '  SDec  i  f  i  ed 


the   PDP-11   terminal 


ACTION 
Return  0 


ALSO  SEE: 

f  s t  og/  1  amp 
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f  Stog 


NAME: 


fstog  -  check  function  switch  toggle 


SYNOPSIS: 

f  st og ( num ) ; 

i  nt  num :   0-31 


DESCRIPTION: 


This  routine  chec<s  the  specified  function  switch  and 
returns  a  one  (t)  and  lights  the  aooropriate  lamp  on 
the  odd  (  1  st / 3 rd, 5t h , . . . . )  depressions  of  the  function 
switch.  The  return  value  and  1 amo  status  remain  the 
same  until  the  next  even  (2nd , 4 t h , 6 1 h , . .  .  . )  depression 
of  the  function  switch  whereupon  a  zero  (0)  is  re- 
turned and  the  lamp  extinguished. 

It  is  not  recommended  to  use  botn  fstog()  and  fsman() 

routines   in   the   same   program;  however*  if  both  are 

used/  disregard  the  lamp  status  of  function  switches 
Queried  by  fsmanf). 


zero 

i 


num 


is  re t  u  rned 
i  s  spec  i  f  i  ed . 


if   an   improoer   function   switch 


DIAGNOSTICS: 


All   errors   will   be   orinted   on  the  PDP-11  terminal 
sc  reen  . 


ERROR    CAUSE 
E-23    ImDroper  function  switch 
' num '  soec  i  f  i  ed 


ACTION 
Return  0 


ALSO  SEE: 

f  sman ,     1 amo 
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i  aet 


i  get 


NAME: 

iget  -  get  an  integer  from  the  VG  keyboard 
SYNOPSIS: 

iget(  [num,xoos*voos)  ); 

int  num:   ASS  /  01    absolute  coordinate  indicator 

float  xoos»ypos;    (x,y)  absolute  coordinate 

To  return  an  integer  and  beqin  input  display  buffer  at 
(-35.0 ,  17.0)  absolute: 

iget (A8S,-25.0, 17.0); 

To  return  an  integer  and  begin  incut  display  buffer  at 
( xm i n , ym i n )  absolute: 

iaet ( ) ; 

DESCRIPTION: 

This  routine  returns  to  the  user  an  integer  from  the 
VG  keyboard.  The  routine  is  similar  to  geti()  and  in 
fact  uses  getiO  to  accomplish  its  task. 

The  ootional  parameters  allow  the  user  to  position  the 
input  display  buffer  anywhere  on  the  display  screen. 
The  'xpos'  ana  'yoos'  parameters  are  absolute  floating 
point  coordinates.  If  no  parameters  are  given  the 
input  disolay  buffer  will  begin  at  (xmin>ymin).  Coor- 
dinate oarameters  which  fall  outside  the  defined  coor- 
dinate system  will  assume  a  value  of  the  nearest  coor- 
oinate  within  the  defined  system. 

The  input  disolay  buffer  is  drawn  with  the  help  of  a 
call  to  the  cget()  routine.  The  input  display  Duffer 
has  a  maximum  size  of  20  characters  before  an  error 
message  is  displayed. 

DIAGNOSTICS: 

All  errors  will  be  orinted  on  the  PDP-11  terminal 
sc  reer\ . 


ERROR    CAUSE 
E-15    Soecified  xpos  out  of  bounds 


ACTION 
xpos  =  xmin 
or  x  ma  x 


ia6 


i  get 


i  get 


E-lb    Soecified  yoos  out  of  bounds 

E-33    Buffer  limit  of  20  characters 
reached 


vpos  =  y m i n 

or  y ma x 

Wai  t  for  CR 

or  CNTRL-A 


ALSO  SEE: 

f get  >    cget 


1U7 


intoffset 


i  ntof  f set 


NAME: 


intoffset  -  object  intensity  offset 


SYNOPSIS: 

intoffset  Cob  j  name  ">val  )  ; 
f 1  oat  val  :   0.0  to  1.0 

DESCRIPTION: 

The  intensity  ranae  of  the  specified  object  is  deter- 
mined by  the  parameter  'val'.  If  'val'  is  one*  the 
maximum  intensity  range  is  achieved.  If  the  value  is 
zero/  the  intensity  is  constant  and  the  image  has  no 
dept  h-cuei  ng. 

DIAGNOSTICS: 

All  errors  will  be  printed  on  the  PDP-11  terminal 
sc  reen . 

ERROR    CAUSE  ACTION 

E-5     Specified  object  does  not           Return 

exist 

E-30    Parameter  'val*  not  0.0  to  1.0      Return 


ALSO  SEE: 

i  nt  sea  1 e 
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i  nt sea  1  e 


intscale 


NAME: 


intscale  -  modify  object  intensity  scale 


SYNOPSIS: 

intscale("objname">val ,cut); 
f 1  oat  val  :    0.0  to  1.0 
i  nt  cut  :    0  o  r  1 

DESCRIPTION: 

The  intensity  ranoe  of  an  object*  which  aives  a 
three-dimensional  object  its  depth  cueing/  is  deter- 
mined by  the  Darameter  'val'.  The  range  of  'val'  is 
from  zero  to  one.  If  'val'  is  one  the  maximum  intensi- 
ty ranae  is  obtained;  if  it  is  zero  the  object  has  no 
deot  h  cueing. 

The  oarameter  'cut'  provides  for  the  use  of  a  screen 
cut-off  plane.  If  the  value  of  'cut'  is  one  then  the 
cut-off  olane  provisions  are  in  effect.  If  the  value 
is  zero  there  will  be  no  screen  cut-off  plane. 

DIAGNOSTICS: 

All  errors  will  be  printed  on  the  PDP-11  terminal 
sc  reen  . 

ERROR    CAUSE  ACTION 

E-5     Soecified  objname  does  not  Return 

exist 

E-30    Parameter  'val'  not  0.0  to  1.0      Return 

E-31    Parameter  'cut'  not  0  or  1  Return 


ALSO  SEE: 

i  nto  f  f se t 
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1  amp 


1  amp 


NAME  : 


amp  -  1 i gh t /ex t i ngu i sh  specified  lam) 


SYNOPSIS: 


1  amp (num, action); 

i  nt  num :   0-31 

i  nt  act  i  on:   OFF  /  00 
ON  /  01 


turn  1  amp  off 
turn  1  amp  on 


DESCRIPTION: 


This  routine  lights/extinguishes  the  specified  lamp 
deoending  on  the  soecified  'action'  Darameter.  An 
'action'  value  of  OFF  will  extinguish  the  specified 
lamp/  while  a  value  of  ON  will  light   the   appropriate 


1  amo . 


An  improper  1 amo  'num'  or  'action'  will  result 


in  no  action  beina  taken. 


DIAGNOSTICS: 


All  errors 
sc  reen  . 


will  be   DPinted 


ERROR 
E-23 
E-2a 


CAUSE 

I  mDrooe  r 

Improoe  r 


on 


the   PDP-11   terminal 


amD  'num'  soec i f i ed 
action'  value  soecified 


ACTION 
Return 
Return 


ALSO  SEE: 

f  stog 
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1 ght Den 


1 gh  t  oen 


NAME: 


IghtDen  -  set  lightoen  sensitivity  of 

the  Di ct ure, ob j ec t  or  elements 


SYNOPSIS: 

IghtDen (act i on , num, "ob j name" , "e 1 e  1" , "ele2", , "elelO")  ; 

int  action:   ON  /  01    set  liqhtoen  sensitivity 

OFF  /  00    clear  HghtDen  sensitivity 

int  num:    PIC  /  00    picture 
OBJ  /  -  1    ob  j  ec  t 
1-10     el emen  t  s 

To  set  sensitivity  of  the  entire  oicture: 

1 ghtDen(act  i  on, PIC)  ; 
To  set  sensitivity  of  an  object: 

lghtoenCact  i  on /OBJ , "ob  j  name"  )  ; 
To  set  sensitivity  of  elements  of  a  SDecific  object: 

1  ght oen (act  ion, num, "objname", "e 1 e 1" , "e 1 e2" , )  ; 

DESCRIPTION: 

The  user  can  SDecify  which  oicture   segments   will  be 

lightDen    sensitive.   These   elements   designated  as 

lightoen  sensitive  will  be  affected  by  liqhtoen  in- 
teraction with  the  vector  general  oisolay  screen. 

The  oarameter  'num'  SDecifies  the  number  of  element 
names  oeing  oassed  in  this  routine  and  may  vary  from  1 
to  10. 


DIAGNOSTICS: 


All  errors  will  be   printed   on   the   PDP-11   terminal 
sc  reen  . 


ERROR  CAUSE 
E-5     Soec i f i ed  objname  does  not 

exist 
E-6     Soecified  element  does  not 

exist 
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ACTION 
Return 

Ski  d 

e 1 ement 


1 gh tpen 


1 gh  toen 


E-18    Parameter  'num'  not  -1  to 
E-22    Element  not  linked  to 
soec  i  f  i  ed  object 


10 


num  =  10 
Skip 

e 1 ement 


ALSO  SEE: 

oenh  i  t  r     c 1 rh  i  t 
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1  i  ne 


1  i  ne 


NAME: 


line  -  draw  a  line 


SYNOPSIS: 


2-di mens i ona 1  coordinate  system 


VR/VA 
VRX/VAX 
VRY/VAY 
VRZ/VAZ 


1 i  ne (oa  r x * pary ) ; 
1  i  ne (oary ) ; 

1 ine(Darx); 
not  all  owed 


3-d i mens i ona 1  coordinate  system 


VR/VA 
VRX/VAX 
VRY/VAY 
VRZ/VAZ 


1 ine(parx*pary*parz)* 
1  i  ne  (oary  *par  z  )  ', 
1  i  ne ( oarx * par z ) ; 
line(oarx*pary); 


float  par x * oary , par z ; 


DESCRIPTION: 


A  line  is  drawn  from  the  present  beam  location  to  a 
position  (x*y*z).  The  location  of  (x*y*z)  depends 
upon  the  vector  tyoe  and  the  specified  parameters.. 

If  the  vector  type  is  absolute/  the  location  of 
(  x  *  y  *  z  )  will  be  (parx*oary*parz).  If  an  auto- 
increment  mode  is  in  effect*  the  designated  auto- 
increment  coordinate  is  left  out  of  the  parameter  list 
and  is  incremented  by  the  designated  increment  to  find 
the  termination  point  of  the  line.  Under  absolute 
vector  tyoes*  parameters  which  fall  outside  the  de- 
fined coordinate  system  will  assume  a  value  of  the 
nearest  coordinate  within  the  defined  system. 


If 


the   vector   tyoe   is   relative*   the   location  of 


(  x  *  y  *  z  )  will  be  the  present 
specified  parameter  values, 
au t o- i nc remen t  modes  do   not 
auto- increment    coordinate 
Under  relative  vector  tyoes* 


beam  location  plus  the 
As  with  absolute  vectors* 
specify  the  designated 
in  the  parameter  list. 
parameters   which   exceed 


one-half  the  coordinate  range  will  be  set  to  zero 


DIAGNOSTICS: 


All   errors   will   be   printed   on  the  PDP-11  terminal 
sc  reen . 
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1  i  ne 


1  i  ne 


ERROR    CAUSE 
E-l     Routine  has  been  called 

outside  a  draweleO  block 
E-2     No  space  available  in 

di  so  1  ay  list 
E-15    Parameter  oarx  out-of-bounds 


E-16    Parameter  pary  out-of-bounds 


E  —  1 7    Parameter  Darz  out-of-bounds 


ACTION 
Return 

Return 

oa  r x  -  xm  i  n 

or  xmax 

or  0.0 

pary  =  ymi  n 

or  y ma  x 

or  0.0 

par z  =  zm  i  n 

or  zma  x 

or  0.0 


ALSO  SEE: 


set  vec  tor 


15a 


man i nt 


man  i  nt 


NAME: 


manint  -  Clear  op  return  manual  interrupt  count 


SYNOPSIS: 

mani  nt ( ac t  i  on) ; 

int  action:   CLEAR  /  00 
COUNT  /  01 


set  count  to  zero 
return  count 


DESCRIPTION: 


This  routine  either  returns  the  present  value 
manual  interrupt  count  or  resets  the  count 
Each  time  the 


of  the 
to  zero . 
manual  interrupt  function  switch  is 
depressed  the  manual  interrupt  count  is  incremented  by 
one  . 


An  'action'  value  of  COUNT  will  return  to  the  user  the 
oresent  manual  interrupt  count,  while  a  value  of  CLEAR 
will  reset  the  count  to  zero.  An  improper  'action' 
value  will  result  in  returning  a  value  of  zero  but  not 
affecting  the  manual  interrupt  count. 


DIAGNOSTICS: 


All   errors   will   be   printed   on  the  PDP-11  terminal 
sc  reen  . 


ERROR    CAUSE 
E-24    Improper  'action'  value 


ACTION 
Return  0 
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move 


move 


NAME: 


move  -  move  to  the  specified  location 


SYNOPSIS: 


2-di mens i ona 1  coordinate  system 


VR/VA 

VRX/VAX 

VRY/VAY 

VRZ/VAZ 


move (par  x , pary ) ; 
move (oary ) ; 
move (Darx) ; 
not  all  owed 


3-d i mens i ona 1  coordinate  system 
VR/VA   :   move  (Darx  ,  oary  ,  narz  )  ', 
VPX/VAX:   move(pary,parz); 
VRY/VAY:   move(oarx,parz) ; 
VRZ/VAZ:   move(Darx,pary); 

float  oar  x  ,  oa  ry  ,  pa  rz  ', 


DESCRIPTION: 


The  beam  is  moved  from  the  oresent  oosition  to  a  posi- 
tion (x*y*z).  The  location  of  (x*y,z)  depends  uoon 
the  vector  type  and  the  specified  parameters. 

If  the  vector  tyoe  is  absolute*  the  location  of 
(x*y*z)  will  be  (pa rx * pa ry * pa rz  )  .  If  an  auto- 
increment  mode  is  in  effect/  the  designated  auto- 
increment  coordinate  is  left  out  of  the  parameter  list 
and  is  incremented  by  the  designated  increment  to  find 
the  termination  point.  Unoer  absolute  vector  tvDes* 
parameters  which  fall  outside  the  defined  coordinate 
system  will  assume  a  value  of  the  nearest  coordinate 
within  the  defined  system. 

If  the  vector  tyoe  is  relative,  the  location  of 
(x,y*z)  will  be  the  oresent  beam  location  plus  the 
specified  parameter  values.  As  with  absolute  vectors* 
auto-increment  mooes  do  not  specify  the  designated 
auto-increment  coordinate  in  the  oarameter  list. 
Under  relative  vector  types*  parameters  which  exceed 
one-naif  the  coordinate  range  will  be  set  to  zero. 


DIAGNOSTICS: 


All  errors  will  be   printed   on   the   PDP-11 
sc  reen  . 


terminal 
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mo  ve 


move 


ERROR    CAUSE 
E-l     Routine  has  been  called 

outside  a  draweleC)  block 
E-2     No  space  available  in 

display  list 
E-15    Parameter  par*  out-of-bounds 


E-16    Parameter  oary  out-of-bounds 


E-17    Parameter  parz  out-of-bounds 


ACTION 
Return 

Return 

pa  r  x  =  xmin 

or  xma  x 

or  0.0 

pary  -    ymin 

or  ymax 

or  0.0 

parz  =  zm  i  n 

or  zmax 

or  0.0 


ALSO  SEE: 


set  vec  tor 
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ob  j  ec t 


ob  j  ec t 


NAME: 


object  -  link  elements  to  specified  object  name 


SYNOPSIS: 

object  (numf,,objnanie%Meler,"ele2", ,  "elelO"  ); 

i  nt  num !   1-10 

DESCRIPTION: 

Associates  with  the  named  object  each  of  the  listed 
elements.  This  oicture  segment*  or  element  grouping 
will  be  referenced  bv  the  object  name  specified  in 
this  routine. 

Every  element  must  be  linked  to  at  least  one  object  in 
order  for  it  to  be  displayed  on  the  Vector  General 
screen.  A  user  can  link  one  or  more  element  names  to 
an  object.  Elements  can  be  linked  to  an  object  by  one 
or  several  calls  to  this  routine.  An  element  can  be 
linked  to  several  different  objects*  or  one  element 
may  be  linked  several  times  to  the  same  object. 

If  an  object  or  element  has  been  erased  from  the 
display  screen,  a  user  can  redisplay  the  desired  ob- 
ject or  elements  by  again  establishing  the  desired 
ob j ec t -e 1 emen t  association. 

The  Darameter  'num'  specifies  the  number  of  element 
names  being  passed  in  this  routine  and  may  vary  from  1 
to  10. 

DIAGNOSTICS: 

All  errors  will  be  orinted  on  the  PDP-11  terminal 
sc  reen  , 


ERROR    CAUSE 
E-6     Specified  element  does  not 

exist 
E-8     Maximum  number  of  elements 

exceeoed 
E-9     Maximum  number  of  objects 

e  xc  eeced 
E-12    Add  element  error 
E-1B    Parameter  'num*  not  1  to  10 
E-21    Add  object  error 


ACTION 

Skip 

el emen t 
Return 

Return 

Return 
num  =  1 0 
Return 
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ob  j  ec t 


object 


E-32    Element  already  linked 


Skip 

e 1 emen t 


ALSO  SEE: 

draweler  cooyele*  erase*  remove 
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offset 


offset 


NAME: 


offset  -  offset  picture  coordinate  axis 


SYNOPSIS: 

offset (xof  f , vof f ) ; 

float  xoff/voff:   -1.0  to  +1.0 

DESCRIPTION: 

This  routine  will  alter  the  positioning  of  the  entire 
oicture  on  the  display  screen.  Normal  or  default  pic- 
ture Dositioning  is  centered  on  the  disolay  screen  and 
corresoonds  to  o f f set ( 0 . 0 , 0 . 0 ) .  Both  the  X  and  Y  axes 
may  be  altered  with  this  routine.  Parameters  outside 
the  range  -1.0  to  +1.0  will  result  in  no  altering  of 
the  soecified  coordinate  axis. 

DIAGNOSTICS: 


All   errors   will 
sc  reen  . 


be   orinted   on  the  PDP-11  terminal 


ERROR    CAUSE 
E-15    Specified  xof f  value 

out -of -bounds 
E-lb    Specified  yoff  value 

ou  t -o  f -bounds 


ACTION 
Skip  X  axis 

a  1 t  er  i  ng 
Skip  Y  axis 

a  1 t er  i  ng 


ALSO  SEE: 


trans 
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penh  i  t 


penh  i  t 


NAME: 

penhit  -  determine  if  ob  j  ec  t  /e  1  ement  lightpen  hit 
SYNOPSIS: 

oenhit(num,"objname","e1ename"); 


int  num:   OBJ  /  -1 
ELE  /  ft 


check  penhit  on  object 
check  penhit  on  element 


To  check  for  lightoen  hit  on  object  'tree': 

oenhi  t (OBJ, "tree") ; 

To  check  for  liqhtDen  hit  on  element  'branch5'  of 
ob  j  ec  t  ' t  ree  '  : 

penhi  t (ELE, "tree"," branchS")  ; 


DESCRIPTION: 


This  routine  checks  to  see  if  an  object  or  element 
within  an  object  has  had  a  lightpen  hit.  The  routine 
returns  to  the  user  a  one  (1)  if  there  has  been  a 
lightoen  hit  on  the  element  or  object,  otherwise  a 
zero  (0)  is  returned.  When  testing  for  a  lightpen  hit 
on  an  object  only  the  first  two  oarameters  are  neces- 
sary, and  a  one  is  returned  if  any  element  within  the 
object  has  hao  a  lightpen  hit. 

The  clrhitO  routine  must  be  called  to  clear  an  object 
or  element  of  lightoen  hits.  Invalid  parameters  will 
result  in  a  zero  being  returned  to  the  user. 

For  an  element  to  register  a  lightpen  hit  the 
element's  lightDen  sensitivity  must  be  activated  with 
the  lghtpenC)  routine  and  the  lightDen,  with  the  sense 
switch  selected,  must  be  held  over  the  element. 


DIAGNOSTICS: 


All  errors  will  be   printed   on   the   PDP-11   terminal 
sc  reen  . 


ERROR  CAUSE 
E-S     Indicated  objname  does  not 

exist 
E-fe     Indicated  elename  does  not 

exist 
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ACTION 
Return  0 

Return  0 


oenh  i  t 


penh  i  t 


E-22    Element  not  linked  to 
SDec  i  f  i  ed  ob  j  ect 


Return  0 


ALSO  SEE: 

1 gh t pen ,  c 1 rh  i  t 
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pi  ace 


place 


NAME: 


olace  -  position  object 


SYNOPSIS: 

ol  aceC'objname",  xabs, yabs  (,zabsJ  ); 
float  xaDs»yabs,zabs; 

DESCRIPTION: 

The  specified  objects  with  all  its  elements*  is  posi- 
tioned at  abso 1 u t e _ 1 ocat i on  ( x abs , y abs t  zabs )  . 

The  z  parameter  is  required  only  when  the  coordinate 
system  is  defined  as  three  dimensional*  and  will  be 
ignored  if  included  under  a  two-dimensional  system. 

DIAGNOSTICS: 

All  errors  will  be  orinted  on  the  PDP-11  terminal 
sc  reen  . 


ERROR    CAUSE 

E-5     Soecified  object  does  not 

exist 

E-15    Soecified  xabs  out-of-bounds 

E-16    Soecified  yabs  out-of-bounds 

E-17    Soecified  zabs  out-of-bounds 


ACTION 
Return 

xabs  =  xm  i  n 

or  x  ma  x 

yabs  =  ym  i  n 

or  ymax 

zabs  =  zmin 

or  zma  x 


ALSO  SEE: 

offset*  t  rans 
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pos  i  t 


DOS  i  t 


NAME: 


Dosit  -  return  coordinate  value  of  specified  device 
cursor 


SYNOPSIS: 

pos  i  t (dev  t coord)  ; 

int  dev:  LPEN  /  00 
TRK  /  01 
JOY  /  02 

i  nt  coora:  X  /  00 
Y  /  01 
Z  /  02 

float  oosi  t ( ) ; 
DESCRIPTION: 


1  i  qh tpen  cursor 
t rac  kball  cursor 
joystick  cursor 

x  coordinate 
y  coordinate 
z  coordinate 


This   routine   returns  to   the   user  a  floating  point 

value  of  the  specified  coordinate   and  device.    The 

value  returned  is  a  value  within  the  user  specified 
coordinate  system. 

This  routine  will  return  the  present  position  of  the 
device  cursor  even  though  the  cursor  may  not  be 
currently  displayed.  A  coordinate  value  of  zero  is 
returned  if  an  improper  parameter  is  received. 

To  obtain  t  ^  e  floating  point  value  from  this  routine 
the  function  declaration  "float  p  o  s  i  t  (  )  J  "  must  be  made 
in  the  users  program. 


DIAGNOSTICS: 


All   errors 
sc  reen  . 


will   be   printed   on  the  PDP-11  terminal 


ERROR  CAUSE 

E-27  Improoer  'dev'  number 

E-29  Improper  'coord'  number 

E-29  No  3D  with  LPEN  or  TRK 


ACTION 
Return  0.0 
Return  0.0 
Return  0.0 


ALSO  SEE: 


cursor 
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prmtv 


printv 


NAME: 


orintv  -  formatted  orintf  routine  for  VG  display 


SYNOPSIS: 


pr i  nt v("el ename"  ,  si  ze, wri  te,  si  ant  ,xpos,ypos,"  format" 
I, arql ,arq2, . . . . ,arql 0]  ); 

int  size:   SZ  /  00  use  orevious  character  size 

SZ1  /  0100  size  =  100  col  x  50  lines 

SZ2  /  0120  size  =  81  col  x  Ul  lines 

SZ3  /  0140  size  =  b0  col  x  30  lines 

SZ4  /  01b0  size  =  32  col  x  lb  lines 

int  write:   HQR  /  00     horizontal  orinting 
VER  /  0200   vertical  printing 

int  slant:   SLNT  /  00    slanted  printing 

MSLNT  /  01    no  slanted  printing 

float  xpoSfVDos;      absolute  coordinates 

A  sample  printed  at  (-25.0,-10.0)  absolute: 

pri nt v ( " test ",SZa,H0R, SLNT, -25. 0,-1 0.0, 

"bravo(51  =  %d" , bravo  (51  ) ; 


DESCRIPTION: 


This  routine  is  a  formatted  print  routine  similar  to 
the  orintfO  routine  except  output  is  to  the  VG 
disolay  screen.  The  routine  is  a  combination  of  the 
chareleO  and  printf ()  routines.  The  routine  uses  the 
first  b  parameters  as  the  chareleO  routine  does  in 
positioning  and  initializing  an  element  structure. 
Coordinate  parameters  which  fall  outside  the  defined 
coordinate  system  will  assume  a  value  of  the  nearest 
coorainate  within  the  defined  system. 

Unlike  chareleO  the  routine  allows  multiple  calls 
upon  the  same  element/  each  call  updating  the 
element's  character  string.  The  routine  allows  for 
formatted  outcut  strings  of  up  to  100  characters  be- 
fore an  error  message  is  displayed. 

Each  new  element  declared  in  a  printvO  routine  uses 
up  57  words  of  the  available  display  list  so  care  must 
be  taken  not  to  declare  too  many  new  elements  in  this 
routine.    It  should  be  remembered  that  an  element  may 
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pr  i  nt  v 


printv 


be  used  repeatedly  with  this  routine. 

Elements  originally  declared  elsewhere  as  either  vec- 
tor drawing  elements  or  character  drawing  elements 
should  not  be  used  in  this  routine.  In  other  words, 
element  names  found  in  this  routine  should  be  unique 
and  should  not  be  found  in  other  drawele()  or 
chareleO  routines. 


DIAGNOSTICS: 


All  errors  w  i 
sc  reen  . 


be   printed 


on 


t  he   PDP-1 1   termi  nal 


ERROR    CAUSE 
E-2     No  more  space  available  in 

d  i  so  1  ay  list 
E-8     Maximum  number  of  elements 

exceeaed 
E-15    Parameter  xoos  out-of-bounds 

E-16    Parameter  yoos  out-of-bounds 

E-34    Formatted  outout  length 

exceeds  100  characters 
E  -  3  5    Imorooer  'write'  parameter 
E-36    Improper  'slant'  oarameter 

E  -  3  7    Improoer  'size'  oarameter 


ACTION 
Return 

Return 

x  s  x  m  i  n 

or  x  ma  x 
y  =  y  m  i  n 

or  yma  x 
Chop  to  1st 
100  char 
write  =  HOR 
slant  = 

NSLNT 
size  =  SZ4 


ALSO  SEE: 

chare  1 e 
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Dsca 1 e 


psca 1 e 


NAME: 


oscale  -  scale  the  picture 


SYNOPSIS: 

pscale(val); 

f 1  oat  val  :   0.0  to  1.0 

DESCRIPTION: 

This  routine  will  scale  the  entire  oicture.  Normal  or 
default  picture  scaling  corresponds  to  pscale(l.O). 
An  improper  DScaleO  parameter  will  result  in  the  pic- 
ture scale  remaining  the  same  as  before  calling  this 
rout  i  ne  . 

DIAGNOSTICS: 

All  errors  will  be  printed  on  the  PDP-11  terminal 
sc  reen  . 

ERROR    CAUSE  ACTION 

E-30    Parameter  'val*  not  0.0  to  1.0      Return 

ALSO  SEE: 


scale 
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ref resh 


refresh 


NAME: 


refresh  -  change  refresh  rate 


SYNOPSIS: 

ref  resh (rate); 

i  nt  rate:   1  to  8 

DESCRIPTION: 

This  routine  will  change  the  refresh  rate  of  the  V  G 
display  screen.  Normal  or  default  refresh  rate  is  40 
Hz  and  corresoonds  to  refresh(3).  To  determine  the 
refresh  rate  for  different  values  use  the  following 
eauat  i  on : 

120  /  rate   =   new  refresh  rate 

DIAGNOSTICS: 


All  errors  w  i 
sc  reen . 


be   orinted 


on 


the   PDP-11   terminal 


ERROR    CAUSE 
E-30    Parameter  'rate'  not  1  to  8 


ACTION 
Return 
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remove 


remove 


NAME: 

remove  -  erase  the  indicated  oortion  of  the  picture 
and  remove  the  associated  element  block 
f  rom  the  di  sol  ay  list 

SYNOPSIS: 

remove (nUm, Hel el " , "el e2" , . . . . , "el  el 0W ) ; 

int  num:     PIC  /  00     all  elements 

1  -  10      soec i f i ed  elements 

To  remove  the  entire  picture: 

remove(PIC ) ; 
To  remove  element  structures: 

remove  (num,Me1  el  ",He1e2%  .  .3  ; 

DESCRIPTION: 

The  entire  picture^  or  every  occurrence  of  the  named 
elements  are  erased  from  the  vector  general  display 
screen.  Each  named  element  structure  will  be  removed 
from  the  display  list.  The  routine  removes  all  occu- 
rences of  the  specified  elements  including  elements 
constructed  with  the  cooyeleC)  routine. 

To  redisplay  any  portion  of  the  removed  oicture  re- 
quires that  t^e  user  rebuild  each  element  and  relink 
it  to  the  aooropriate  objects. 

The  oarameter  'num'  specifies  the  number  of  element 
names  being  passed  in  this  routine  and  may  vary  from  1 
to  10. 

DIAGNOSTICS: 

All  errors  will  be  printed  on  the  PDP-11  terminal 
sc  reen . 


ERROR    CAUSE 
E-6     Specified  element  does  not 

exist 
E-18    Parameter  *num'  not  1  to  10 


ACTION 
Sk  i  p 

e 1 emen t 
num  =  1  0 


ALSO  SEE: 

erase/  display 
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rotate 


rotate 


NAME: 


rotate  -  rotate  an  object 


SYNOPSIS: 

rot  ate ( "ob j name" , x radi ans , yradi ans  [»zradiansl  ); 
float  xpadians/vradians/zradians* 

DESCRIPTION: 

The  named  object  will  be  rotated  about  the  x,  v»  z 
coordinate  axis.  The  Darameters*  given  in  radian  meas- 
ure* specify  the  degree  of  rotation  desired  about  each 
axis. 

The  z  parameter  is  reauired  only  when  the  coordinate 
system  is  defined  as  three  dimensional  and  will  oe 
ignored  otherwise. 

DIAGNOSTICS: 


All  errors  will  be   printed 
sc  reen . 


on 


the   PDP-11   terminal 


ERROR    CAUSE 
E-5     Soec i f i ed  objname  does  not 
exist 


ACTION 
Return 
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scale 


sea  1  e 


NAME: 


scale  -  modify  object  scale 


SYNOPSIS: 

seal e C" ob j name" ,    scale); 
float  seal e :   0.0  to  1.0 

DESCRIPTION: 

AH  elements  associated  with  the  named  object  are 
scaled  by  the  value  scale  at  display  time.  The  range 
of  scale  is  from  zero  to  one.  Normal  or  default  ob- 
ject scaling  corresponds  to  scaleC" obj name"*  1.0). 

DIAGNOSTICS: 

All  errors  will  be  Drinted  on  the  PDP-11  terminal 
sc  reen . 

ERROR    CAUSE  ACTION 

E-5     Specified  objname  does  not  Return 

exist 

E-30    Parameter  'scale'  not  0.0  to  1.0    Return 


ALSO  SEE: 

osca 1 e 
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set  vec  t or 


setvector 


name  : 


setvector  -  specify  the  vector  type  and  vector  mode 


SYNOPSIS: 


set vec tor ( vt yce, vmode  ( / i nc]  [  / sea  1  el  ); 


i  nt 


vt yoe : 
VR 
VRX 
VRY 
VRZ 
VA 
VAX 
VAY 
VAZ 
INC2 
INCX 
INCY 
INC3 


vec  tor 
vec  tor 
vector 
vector 
vector 
vector 
vector 
vector 
vec  tor 
vector 
vec  tor 
vector 


rel at  i  ve 

relative  auto-increment 
relative  auto-increment 
relative  auto- increment 
abso 1 u t  e 
abso 1 ute 
abso 1 ute 
abso 1 ute 


aut  o- 1 nc  remen t  x 
auto-increment  y 
auto-increment  z 
incremental  2-d i mens i ona 1 
incremental  auto-increment 
incremental  auto-increment 
incremental  3-di mens i ona 1 


i  nt 


vmode : 
LN 
DSH 
DOT 
PNT 
DO 
ODD 


/   0  0  -  line 

/  020  -  dashed  1  i  ne 

/  Oao  -  dot  ted  line 

/  060  -  end  po  i  n t 

/ 0 1 20  -  dash-dot-dash 

/0140  -  dash-dot-dash 


I  1  ne 
l  i  ne 


float  scale: 

MG  /  128.0 


NMG  /  0.0 


add  the  coordinate  increments 
to  the  high  order  d  i  t  s  of  the 
specified  register, 
add  the  coordinate  increments 
to  the  low  order  bits  of  the 
soecified  register. 


float  inc? 


DESCRIPTION: 


This  routine  specifies  which  one  of  the  12  vector 
tyoes  is  to  be  drawn  in  the  line/  move/  circle  and  arc 
instructions  which  follow.  It  also  specifies  the  vec- 
tor mode  (i.e./  line/  dotted/  dashed/  etc.)/  and  if 
reguired/  the  increment  value  for  auto-increment  vec- 
tors and  the  scale  factor  for  incremental  vectors. 
The   coordinate   values   oassed   in  the  following  draw 
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set  vec  tor 


set  vec  tor 


instructions  are  deoenaent  on  the  vector  tvoe  selected 
in  this  rout  i  ne . 

This  must  follow  a  draweleC)  call  and  Dreceed  any  draw 
instructions.  This  routine  can  be  called  any  number  of 
times  within  a  draw  element  block. 

The  bracketed  z  parameters  are  required  only  when  the 
coordinate  system  has  been  defined  as  three  dimension- 
al . 


DIAGNOSTICS: 


All   errors 
sc  reen . 


will   be   printed   on  the  PDP-11  terminal 


ERROR 
E-l 

E-2 

E-l  0 

E-14 
E-15 


E-lto 


E-l  7 


CAUSE 

Routine  has  been  called 
outside  a  drawele()  block 
No  soace  available  in 
display  list 
Improoer  vector  mode 
Improper  vector  tvoe 
Specified  xinc  out-of-bounds 


Specified  yinc  out-of-bounds 
Soecified  zinc  out-of-bounds 


ACTION 
Return 

Return 

vmoae  =  LN 

vtype  =  VA 

xinc  =  xm  i  n 

or  xma x 

or  0.0 

yinc  =  ym  i  n 

or  yma  x 

or  0.0 

zinc  =  zm  i  n 

or  zmax 

or  0.0 
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set  vector  -  V  A 


setvector  -  VA 


NAME: 


VA  -  vector  absolut 


SYNOPSIS: 


drawele(Helename"); 


setvector(VA,vmode) ; 

move (coordx i coordv     Ucoordzl     ); 

M ne (coorax f coordv     C^coordz]     ); 

circle(dir,centx,centv     [ ,  c  e  n  t  z  3     ); 

apc(dir,centx,centy     IfCentz) »endx/endy     [/endz]     ); 


endel e( ) ; 

float  coordx / coordy # coo rdz ; 

float  centx,centy/centz,endx/endy,endz; 


DESCRIPTION: 


The  x,y,z  coordinates  of  absolute  vectors  are  speci- 
fied with  respect  to  the  origin,  or  zero  position  of 
the  user  defined  coordinate  system.  Each  x,  y,  z  coor- 
dinate value  references  a  unique  point  on  the  display 
screen.  Under  this  vector  type,  coordinate  parameters 
for  move/line/arc/circle  commands  which  fall  outside 
the  defined  coordinate  system  will  assume  a  value  of 
the  nearest  coordinate  within  the  aefined  system. 


DIAGNOSTICS: 


All   errors 
sc  reen . 


will   be   printed   on  the  PDP-11  terminal 


ERROR    CAUSE 
E-l     Routine  nas  been  called 

outside  a  draweleO  block 
E-2     No  soace  available  in 

display  list 
E-10    Improper  vector  mode 
E-1'4    Improoer  vector  tyoe 


ACTION 
Return 

Return 

vmode  =  LN 
v  t  ype  =  VA 
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setvector  -  VAX 


set vec  tor  -  VAX 


NA^E: 


VAX  -  vector  absolute  auto- increment 


SYNOPSIS: 

draweleCelename"); 


setvector(VAX,vmode,xinc); 
move (coorov     l»coordzl     ); 
line(coordy     UcoordzJ     ); 

circle(diP/centy     [,centz]     ); 

arc (di r , cent y     l^centz) »endy     [»endz]     ); 


endel e (  )  ; 

float  xinc>coordvrCoordz; 
float  cent y / cent z f endy / endz ; 


DESCRIPTION: 


The  vector  absolute  auto-increment  x  causes  the  ini- 
tial x  coordinate  value  to  be  incremented  or  decre- 
mented by  the  value  soecified  by  '  xinc'.  with  every 
move/ 1  i ne/arc /c i re  1 e  command  the  specified  v  and  z 
coordinate  values  are  undated  while  the  x  coordinate 
value  is  incremented  by  the  constant  value  'xinc'. 
For  examole>  the  point  (x»y»z)  becomes  point  (x+xinc* 
coordy / coordz )  .  Under  this  vector  tyoe»  coordinate 
Darameters  for  move/line/arc/circle  commands  which 
fall  outside  the  defined  coordinate  system  will  assume 
a  value  of  tne  nearest  coordinate  within  the  defined 
system. 

A  'xinc'  parameter  exceeding  one-half  the  coordinate 
range  will  be  set  to  zero. 


DIAGNOSTICS: 


All  errors 
sc  reen  . 


ill  be   printed 


on 


the   PDP-1 1   termi  nal 


ERROR    CAUSE 
E-l     Routine  has  been  called 

outside  a  draweleO  block 
E-2     No  space  available  in 

d  i  s  o 1  a  y  list 
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ACTION 
Ret  u  rn 

Return 


setvector  -  VAX 


setvector  -VAX 


E-10  Improoer  vector  mode 
E-14  I^DPooer  vector  tyoe 
E-15    Soec i f i ed  'xinc'  out-of-bounds 


vmooe  =  LN 
v t  ype  =  V  A 
xinc  =  0.0 
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set  vector  -  VAY 


set  vector  -  VAY 


NAME  : 


VAY  -  vector  absolute  auto-increment 


SYNOPSIS: 

draweleC'elename"); 


setvector(VAY,vmode,yinc) ; 

move(coordx     l»Coordzl     ); 

lineCcoordx     UcoordzJ     ); 

cipcle(dir,centx     Ccentzl     ); 

arc (di r, cent x     C ,  cent zl  / endx     t»endz]     ); 


endel e( ) ; 

float  y i nc f coo rdx / coordz ; 
float  cent x , cent z , endx , endz ; 


DESCRIPTION: 


The  vector  absolute  auto-increment  y  causes  the  ini- 
tial y  coordinate  value  to  be  incremented  or  decre- 
mented Dy  the  value  specified  by  'yinc  '  .  with  every 
move/ 1  i ne/arc /c i re  1 e  command  the  SDecified  x  and  z 
coordinate   values  are    updated  while  the  y  coordinate 


value  is  incremented  by   the   constant   value 


y  i  nc 


For  examole*  the  point  (x,y,z)  becomes  the  point 
(coordx / y+y i nc / coordz ) .  Under  this  vector  type,  coor- 
dinate parameters  for  move/ 1  i ne/a re /c i re  1 e  commands 
which  fall  outside  the  defined  coordinate  system  will 
assume  a  value  of  the  nearest  coordinate  within  the 
de  f  i  ned  system. 


A   'yinc'   oarameter  exceeding  one-half  the  coordinate 
range  will  be  set  to  zero. 


DIAGNOSTICS: 


All  errors 
sc  reen  . 


ill  be   printed 


on 


the   PDP-11   terminal 


ERROR    CAUSE 
E-l     Routine  has  been  called 

outside  a  draweleO  block 
E-2     No  space  available  in 
di  sp 1  ay  list 
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ACTION 
Return 

Return 


set  vec  tor  -  V  AY 


setvector  -  VAY 


E-10  •  Improper  vector  mode 
E-14  Improper  vector  type 
E-16    Specified  'yinc*  out-of-bounds 


vmode  =  LN 
vt  ype  =  VA 
yinc  =  0.0 
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set  vector  -VAZ 


setvector  -  VAZ 


NAME: 


VAZ  -  vector  absolute  auto-increment  z 


SYNOPSIS: 


drawel e("el ename") ; 


setvector(VAZ,vmode>zinc) ? 

move(coorcx^coordy) ; 

1 ine(coorox,coordy) ; 

ci  re  1 e (di  r,centx,centy)  ; 

arc  Cdi  r,centx,centy,endx,endy) ? 


ende 1 e (  )  ; 

float  z i nc / coo rdx r coordy ? 
float  cen t x , cen t y t endx , endy ? 


DESCRIPTION: 


The   vector   absolute  au 
tial  z  coordinate  value 
mented   by   the   value  s 
move/ 1  i ne/arc/c i re  1 e  com 
coordinate   values  are 
value  is  incremented  by 
For   examole>   the   coin 
(coordx,coory,z  +  zinc)  . 
dinate   Darameters   for 
which  fall  outside  the  d 
assume   a   value   of  the 
aef  i  ned  system. 


to-increment  z  causes  the  ini- 
to  be  incremented  or  decre- 
pecified  by  'zinc'.  With  every 
mand  the  specified  x  and  y 
undated  while  the  z  coordinate 

the  constant  value  'zinc', 
t  (x,y,z)  becomes  the  point 
Under  this  vector  type>   coor- 

move/ 1  i ne/arc/c i re  1 e  commands 
efined  coordinate  system   will 

nearest  coordinate  within  the 


A   'zinc'   oarameter  exceeding  one-half  the  coordinate 
range  will  be  set  to  zero. 


DIAGNOSTICS: 


All  errors 

sc  reen  , 


ill  oe   printed 


on 


the   PDP-1 1   termi  nal 


EPROR    CAUSE 
E-l     Routine  has  been  called 

outside  a  draweleO  block 
E-2     No  space  available  in 
di  so  1  ay  list 


ACTION 
Return 

Return 
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setvector  -  VAZ 


set  vec  tor  -  VAZ 


E-10  Improper  vector  mode 
E-14  Improoer  vector  type 
E-17    Specified  'zinc'  out-of-bounds 


vmode  =  LN 
v  t  voe  =  VA 
zinc  =  0.0 
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setvector  -  VR 


set  vec  tor  -  VR 


NAME:  VR  -  vector  relative 

SYNOPSIS: 

draweleCelename"); 


setvector(VR,vmode); 

move(del tax ,del t ay  (,deltazl  ); 

1 i ne(del tax , del tay  (,deltazl  ); 

c i re  1 e (di r, cent x , cent y  (rcentzl  ); 

arc(airfcentXfCenty  trcentzl ;endx»endy  [  /  e  n  d  z  1  ); 


endel e ( ) ; 

float  del t ax ,ael t ay ,de1 t az ; 

float  centx/centy/CentZ/endx/endyfendz/ 


DESCRIPTION: 


Relative  vectors  specify  an  increment  value  that  is  to 
be  added  to  or  subtracted  from  the  initial  x , y , z  beam 
position.  For  example/  the  point  (x,y,z)  becomes 
point  (x+del t ax , y+del tay/Z+del taz) . 

Under  this  vector  type*  coordinate  parameters  for 
mo ve/ 1  i ne/a re /c i re  1 e  commands  which  exceed  one-half 
the  coordinate  range  will  be  set  to  zero. 


DIAGNOSTICS: 


All  errors  will  be 
sc  reen . 


pr  i  n  t  ed   on 


ERROR    CAUSE 
E-l     Routine  has  been  called 

within  a  draweleC)  block 
E"2     No  space  available  in 

display  list 
E-10    Improper  vector  mode 
E-14    Improper  vector  type 


the   PDP-1  1   termi  nal 


ACTION 
Return 


Return 

v  m  o  d  e  =  L  N 
vtype  =  VA 
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setvector  -  VRX 


setvector  -  VRX 


NAME: 


VRX  -  vector  relative  auto-increment 


SYNOPSIS: 

draweleCelename"); 


setvector(VRX,vrnode»xinc) 

move(deltay  l/deltazl  ); 

line(deltay  [rdeltazl  ); 

C i re  1 e(di r ,centy  [»centz]  ); 

arc (di recent y  C , cent z) , endy  l/endz)  ); 


ende 1  e  (  )  ; 

float  x i nc r del t ay r de 1 t az ; 
float  cent y , cent z , endy , endz ; 


DESCRIPTION: 


A  vector  relative  auto-increment  x  causes  the  initial 
x  coordinate  value  to  be  incremented  or  decremented  bv 
the  constant  value  '  x i nc  '  .  With  everv  move/ 1  i ne/arc/ 
circle  instruction  that  follows/  the  y  and  z  coordi- 
nate values  will  be  undated/  while  x  is  steeped  by  the 
value  'xinc'.  For  examole»  the  Doint  (x,y,z)  becomes 
the  Doint  ( x  +  x i nc t  y +  de 1 t ay f  z tde 1 t az  )  . 

Under  this  vector  tyoe>  coordinate  parameters  for 
move/ 1  i ne/arc /c i re  1 e  commands  which  exceed  one-half 
the  coordinate  range  will  be  set  to  zero. 


DIAGNOSTICS: 


All   errors 
sc  reen  . 


will   be   printed   on  the  PDP-11  terminal 


ERROR    CAUSE 
E-l     Routine  has  been  called 

outside  a  draweleO  block 
E-2     No  space  available  in 

d  i  so  1  ay  list 
E-10    Improper  vector  mode 
E-14    Improper  vector  type 
E-15    Soecified  'xinc'  out-of-bounds 


ACTION 
Return 

Return 

vmode  =  LN 
v t  ype  =  V  A 
xinc  =  0.0 
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setvector  -  VRY 


setvector  -  VRY 


NAME: 


VRY  -  vector  relative  auto-increment  y 


SYNOPSIS: 

draweleCelename"); 


setvector(VRY,vmoae,yinc) 

moveCdeltax     UdeltazJ     ); 

1 i  ne(de1 tax     [/del taz)     ) ; 

c i re  1 e(di r,cent x     [/centzJ     ); 

arc  (di  r,  cent  x     [»centzl  ^endx     UendzJ 


); 


endeleC ) ; 

float  y i nc / de 1 t ax , del t az ; 
float  cen t x , cent z / endx , endz I 


DESCRIPTION: 


A  vector  relative  auto- increment  y  causes  the  initial 
y  coordinate  value  to  be  incremented  or  decremented  by 
the  constant  value  'yinc'.  flith  every  move/ 1 i ne/arc / 
circle  instruction  that  follows/  the  x  and  z  coordi- 
nate values  will  be  updated/  while  y  is  incremented  by 


the   value 


v  i  nc 


For   example/   the  point  (x/y/z) 


becomes  the  point  ( x tdel t ax / y  +  y i nc / z+del t az )  . 

Under  this  vector  type/  coordinate  parameters  for 
■nove/1  ine/arc/ci  rele  commands  which  exceed  one-half 
the  coordinate  ranae  will  be  set  to  zero. 


DIAGNOSTICS: 


All   errors 
sc  reen  . 


ill   be   printed   on  the  PDP-11  terminal 


ERROR    CAUSE 
E-l     Routine  has  been  called 

outsiae  a  draweleO  block 
E-2     No  space  available  in 

di  sol  ay  list 
E-10    Improper  vector  mode 
E-14    ImDrooer  vector  type 
E-16    Specified  'yinc'  out-of-bounds 


ACTION 
Return 

Return 

vmode  =  LN 
v t  ype  =  V  A 
yinc  =  0.0 
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setvector  -  VRZ 


NAME: 


VRZ  -  vector  relative  auto-increment  z 


SYNOPSIS: 


draweleCelename")  ; 


setvector(VRZ»vmode,zinc) 

move (de 1 t  ax , de 1 tay) ? 

1 i  ne (del t  ax , del t  av ) ; 

ci  rcleCdi  r,centx,centy) ; 

arc (di  r,centx,centy»endxfendy); 


endel e(  )  ; 

float  z i nc / de 1 t ax / de 1 t ay ; 
float  cen t x , cent y > ennx , endy ; 


DESCRIPTION: 


A  vector  relative  auto-increment  z  causes  the  initial 
z  coordinate  value  to  be  incremented  or  decremented  by 
the  constant  value  'zinc'.  with  every  move/line/arc/ 
circle  instruction  that  follows/  the  x  and  y  coordi- 
nate values  will  be  u  p  d  a  t  e  d  >  while  z  is  incremented  by 
the  value  'zinc'.  For  examole/  the  point  (x,y,z) 
Decomes  the  point  (x+deltax,y+deltay>z+incz). 

Under  this  vector  type*  coordinate  parameters  for 
move/line/arc/circle  commands  which  exceed  one-half 
the  coordinate  range  will  be  set  to  zero. 


DIAGNOSTICS: 


All   errors 
sc  reen  . 


will   be   printed   on  the  PDP-11  termina 


ERROR    CAUSE 
E-l     Routine  has  been  called 

outside  a  draweleO  block 
E-2     No  soace  available  in 

di  spI ay  list 
E-10    Improper  vector  mode 
E-14    Improper  vector  tvpe 
E-17    Soecified  'zinc'  out-o f -bounas 


ACTION 
Return 

Return 

vmode  =  LN 
v t  ype  =  V  A 
zinc  =  0.0 
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setvector  -  INC2 


NAME: 


I N  C  2  -  incremental  vector;  two-dimensional 


SYNOPSIS: 


drawel e("el ename" ) ; 


setvector(INC2^vmodefScale); 
move(de1 tax  $  del t  ay  ) i 
1 i  ne (del t ax , del t ay ) ; 


enael e ( ) ; 


float  deltax,aeltay; 


float  sea  1 e : 

MG  /  128.0 


NMG  /   0.0 


add  the  coordinate  increments  to 
the  7  high  order  bits  of  the 
SDecified  register. 
add  the  coordinate  increments  to 
the  7  low  order  bits  of  the 
soecified  register. 


DESCRIPTION: 


A  two-dimensional  relative  vector  that  halves  vector 
storage  requirements  and  doubles  the  data  rate.  This 
vector  tyoe  should  be  used  when  element  storage  space 
is  critical.  This  reduced  storage  requirement  results 
from  a  limitation  on  the  maximum  size  of  each  relative 
increment.  The  values  passed  in  move/line  instructions 
are  limited  to  approximately  3%  of  the  user  minimum 
and  maximum  coordinate  ranges.  Should  coordinate 
parameters  for  move/line  commands  exceed  the  3%  limits 
they  will  be  reduced  to  satisfy  the  constraint. 

The  parameter  'scale'  specifies  whether  this  increment 
value  should  be  added  to  the  7  high  order  bits  of  the 
soecified  coordinate  or  to  the  7  low  order  bits.  This 
scale  factor  then  determines  if  the  increments  will  be 
applied  over  a  fine(NMG)  or  coarse(MG)  grid. 


Arcs   and 

t  ype  . 


circles   cannot   be   drawn  with  this  vector 
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set  vector  -  INC2 


DIAGNOSTICS: 


All  errors  will  be   printed 
sc  reen . 


on 


the   PDP-11   terminal 


ERROR    CAUSE 
E-l     Routine  has  been  called 

outsioe  a  draweleO  block 
E-2     No  space  available  in 

di  sd 1  ay  list 
E-14    Improper  vector  type 


ACTION 
Return 

Return 

vtype  =  VA 
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setvector  -  I N  C  3 


set  vec tor  -  INC3 


NAME: 


INC3  -  incremental  vector;  three-dimensional 


SYNOPSIS: 


drawel e( "el ename"  ) ; 


setvector(INCX,vmodefScale); 
move (del t  ax ,del t ay ,del taz)  ; 
1 ine(del t ax , de 1 t  ay , de 1 taz)  ; 


endel  e()  ', 


float  del  tax , del t ay , del taz ; 


float  scale: 

MG  /  128.0 


NMG  /   0.0 


add  the  coordinate  increments  to 
the  7  high  order  bits  of  the 
soec i f i ed  register, 
add  the  coordinate  increments  to 
the  7  low  order  bits  of  the 
SDecified  register. 


DESCRIPTION: 


A  three-dimensional  relative  vector  that  halves  vector 
storage  requirements  and  doubles  the  data  rate.  This 
vector  type  should  be  used  when  element  storage  space 
is  critical.  This  reduced  storage  requirement  results 
from  a  limitation  on  the  maximum  size  of  each  relative 
increment.  The  values  passed  in  move/line  instructions 
are  limited  to  aop rox i ma t e 1 y  3%  of  the  user  minimum 
and  maximum  coordinate  ranqes.  Should  coordinate 
parameters  for  move/line  commands  exceed  the  3%  limit? 
they  will  be  reduced  to  satisfy  the  constraint. 

The  parameter  'scale*  specifies  whether  this  increment 
value  should  be  added  to  the  7  high  oraer  bits  of  the 
specified  coordinate  or  to  the  7  low  oraer  bits.  This 
scale  factor  then  determines  if  the  increments  will  be 
applied  over  a  fine(NMG)  or  coarse(VG)  grid. 


Arcs  and  circles  cannot 
t  ype . 


be   drawn   with   this   vector 
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setvector  -  INC3 


set  vector  -  INC3 


DIAGNOSTICS: 


All   errors   will   be   printed   on  the  PDP-11  terminal 
sc  reen . 


ERROR    CAUSE 
E-l     Routine  has  been  called 

outsiae  a  draweleO  block 
E-2     No  SDace  available  in 

display  list 
E-14    Improper  vector  type 


ACTION 
Return 

Return 

vtype  =  VA 
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setvector  -  INCX 


NAME: 


INCX  -  incremental  vector;  two-dimensional 
auto-increment  x 


SYNOPSIS: 


draweleCelename"); 


setvector(INCX,vmode>xinc, scale)? 
move(del t  ay  »  de 1 tay)  ; 
1 i  ne (del t  ay , de 1 tay) ; 


endel e (  )  ; 


float     xiriCfdel  tayl 

float  scale: 

MG  /  128.0 


NMG  /   0.0 


add  the  coordinate  increments  to 
the  7  high  order  bits  of  the 
SDecified  register, 
add  the  coordinate  increments  to 
the  7  low  order  bits  of  the 
specified  register. 


DESCRIPTION: 


A  two-dimensional  relative  vector  that  halves  vector 
storaae  reguirements  and  doubles  the  data  rate.  This 
vector  tyoe  should  be  used  when  element  storage  space 
is  critical.  This  reduced  storaae  requirement  results 
from  a  limitation  on  the  maximum  size  of  each  relative 
increment.  The  values  passed  in  move/line  instructions 
are  limited  to  approximately  3%  of  the  user  minimum 
and  maximum  coordinate  ranges.  Should  the  coordinate 
parameters  for  move/line  commands  exceed  the  3%  limit/ 
they  will  be  reduced  to  satisfy  the  constraint. 

The  parameter  'scale'  specifies  whether  this  increment 
value  should  be  added  to  the  7  high  oraer  bits  of  the 
specified  coordinate  or  to  the  7  low  order  bits.  This 
scale  factor  then  determines  if  the  increments  will  be 
apolied  over  a  fine(NMG)  or  coarse(MG)  grid. 

This  incremental/  auto-increment  vector  causes  the  x 
coordinate  value  to  be  incremented  or  decremented  by 
the  constant  value  ' x i nc  '  /  while  the  y  coordinate 
value   is   increment   by   small   relative  values.   The 


x  i  nc 


value   need   not   be   limited 


to 


3%   of   the 
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setvector  -  INCX 


set  vec t or  -  INCX 


coordinate  range  but  may  not  exceed  one-half  the  coor- 
dinate range  or  it  will  be  set  to  zero. 

Arcs   and   circles   cannot   be   drawn  with  this  vector 
t  voe . 


DIAGNOSTICS: 


All  errors  will  be   printed 
sc  reen . 


on 


the   PDP-11   terminal 


EPROR    CAUSE 
E-l     Routine  has  been  called 

outside  a  arawele()  block 
E-2     No  space  available  in 

d  i  s  o 1  a  y  list 
E-14    Improper  vector  tyoe 
E-15    Specified  'xinc*  out-of-bounds 


ACTION 
Return 

Return 

vtype  =  VA 
xi  nc  =  0.0 
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setvector  -  INCY 


set  vec  tor  -  INCY 


NAME: 


INCY  -  incremental  vector;  two-dimensional 
aut  o- i  nc  remen t  y 


SYNOPSIS: 


drawel e( Hel ename") ; 


set vector ( INCY r  vmode* yi  nc  r  seal e); 

move (de! tax , del  tax) ; 
1 i  ne (de 1 t  ax , de 1 t  ax )  ; 


ende 1 e ( ) ; 


float  yinc/deltax; 


float  scale: 
MG  /  128.0 


NMG  /   0.0 


ado  the  coordinate  increments  to 
the  7  high  order  bits  of  the 
SDecified  register, 
add  the  coordinate  increments  to 
the  7  low  order  bits  of  the 
specified  register. 


DESCRIPTION: 


A  two-dimensional  relative  vector  that  halves  vector 
storage  requirements  and  doubles  the  data  rate.  This 
vector  type  should  be  used  when  element  storage  space 
is  critical.  This  reduced  storage  requirement  results 
from  a  limitation  on  the  maximum  size  of  each  relative 
increment.  The  values  passed  in  move/line  instructions 
are  limited  to  approximately  3%  of  the  user  minimum 
and  maximum  coordinate  ranges.  Should  the  coordinate 
parameters  of  move/line  commands  exceed  the  3%  limit, 
they  will  be  reduced  to  satisfy  the  constraint. 

The  parameter  'scale'  specifies  whether  this  increment 
value  should  be  added  to  the  7  high  order  bits  of  the 
specified  coordinate  or  to  the  7  low  order  bits. 
This  scale  factor  then  determines  if  the  increments 
will  be  applied  over  a  fineCNMG)  or  coarse(MG)  grid. 


This  incremental,  auto-increment  vector  causes  the  y 
coordinate  value  to  be  incremented  or  decremented  by 
the  constant  value   'yinc',   while   the   x   coordinate 


value 

' y  i  nc  ' 


is   increment   by   small   relative  values.   The 
value   need   not   be   limited   to   3%   of   tne 


191 


setvector  -  INCY 


set  vec  tor  -  INCY 


coordinate  range  but  may  not  exceed  one-half  the  coor- 
dinate range  or  it  will  be  set  to  zero. 

Arcs   and   circles   cannot   oe   drawn  with  this  vector 
t  ype . 


DIAGNOSTICS: 


All  errors  will  be   printed   on   the   PDP-11   terminal 
sc  reen  . 


ERROR    CAUSE 
E-l     Routine  has  been  called 

outside  a  draweleO  block 
E-<?     No  space  available  in 

d  i  so  1 av  list 
E-14    ImproDer  vector  type 
E-16    Soecified  '  yinc'  out-of-bounds 


ACTION 
Return 

Return 

vt  ype  =  V  A 
yinc  =  0.0 
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svs i ni t 


sy s  i  n  i  t 


NAME: 


sysinit  -  vector  general  display  initialization 


SYNOPSIS: 

sysinit  (aevnutr); 

i  nt  devnum :   0  or  1 


DESCRIPTION: 


This  routine  establishes  a  link  with  the  vector  gen- 
eral ,  initializes  its  display  system  and  sets  all  the 
user  default  parameters.  The  routine  allows  for 
soec i f i c a t i on  of  which  VG  device  the  user  desires  to 
utilize.  The  VG  devices  are  numbered  0  and  1.  Should 
the  system  be  unable  to  allocate  the  specified  VG  dev- 
ice, allocation  of  the  other  VG  device  will  be  at- 
t  emot  ed . 


Th  i  s   rout  i  ne 
i  nst  rue  t ions. 


must  be  called  before  any  other  display 


DIAGNOSTICS: 


If  initialization  of  the  specified  VG  device  cannot  be 
comoleted/  an  error  message  will  be  printed  out  and 
the  system  will  attemot  to  initialize  the  other  VG 
device.  The  system  will  terminate  the  process  only  if 
both  initialization  attempts  fail. 


All   errors 
sc  reen . 


ill   be   printed   on  the  PDP-11  terminal 


ERROR    CAUSE 
E-27    Imoroper  VG  devnum  specified 


ACTION 
devnum  =  0 
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t  rans 


NAME: 


trans  -  translate  object 


SYNOPSIS: 

t  ransCob  jname"  ,del  tax  ,del  tay  t/deltazl  ); 
float  de 1 t ax , de 1 t ay / del t az \ 

DESCRIPTION: 

All  of  the  elements  associated  with  the  named  object 
are  translateo  from  their  present  location  (X,Y,Z)  to 
(X+de1tax,Y*deltay,Z+deltaz). 

The  2  Darameter  is  reauired  only  when  the  coordinate 
system  is  defined  as  three  dimensional/  and  will  be 
ignored  if  included  under  a  two-dimensional  system. 

DIAGNOSTICS: 


All  errors  will 
sc  reen  . 


be   or  i  n  t ed 


on 


the   PDP-11   terminal 


ERROR    CAUSE 

E-5     Specified  object  does  not 

exist 

E-15    Soec i f i ed  deltax  ou t -o f -bounds 

E-16    Specified  deltay  out-of-bounds 

E-17    Soec i f i ed  deltaz  out-of-bounds 


ACTION 
Return 

del  tax  =  0.0 
del tay  =  0.0 
del taz  =  0.0 


ALSO  SEE: 

of  f set /  pi  ace 
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vgpicture 


NAME: 


vqpicture  -  start  refresh  of  VG  picture  display 


SYNOPSIS: 

vgpi  ctureO; 

DESCRIPTION: 

This  routine  must  be  called  to  initiate  the  display  of 
elements  on  the  VG  disolay  screen.  The  routine  need 
be  called  only  once.  The  displayU  routine  may  be 
called  after  this  routine  to  activate  or  deactivate 
the  disolay  of  all  or  parts  of  the  display  picture. 

DIAGNOSTICS: 
none 

ALSO  SEE: 

display*  erase*  remove 
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vgt  e  rm 


vqterm 


^AME: 


vgterm  -•  terminate  display  and  close  VG  device 


SYNOPSIS: 

vgterm  ( )  ; 

DESCRIPTION: 

This  routine  should  be  included  at  the  end  of  the 
user's  program  to  prooerly  terminate  the  display  and 
close  the  VG  device.  Should  the  user's  program  con- 
tain an  endless  loop»  depressing  the  'rubout'  key  will 
accomplish  the  same  task. 

DIAGNOSTICS: 


none 
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